Re: Questions about the state of doc.t.o
Thank you both for theses quick answers, as always 😉
@Xavier de Pedro:
Imho the main documentation structure should disappear because:
It is confusing to have 2 differents structures for the sames pages. Once you got to know your way in one, you'll have a hard time figuring out how to navigate from a page displaying another structure.
As rick noted, a page with 2 structures will not even display one if accessed via a link like this one
. I really wish that users of my website I send to thoses kind of pages "stay" in the user structure. I know I could add the structure as an URL variable, but I have the feeling it would make sense in a broader way.
Although you are right that power-users like to have all-in-one-page, this would still be possible either via grouping the guides in one mega-structure or by displaying all tocs in one page.
Of course, a default structure option would be just as awsome, I second this feature request (and then I could also go on adding more structures to my own website).
@rick: If I understand this page
correctly, the main aim is to spread all pages of the documentation structure into 3 differents structures, is this right?
How many pages didn't go through the process, and which?
And what is the difference between "Reference Guide" and "Administrators Guide"?
I had a second thought about splitting the page Wiki-Syntax Links
. I still want to split it, but no inclusion in the admin or reference guides. This page is mostly for users, just too much in deep. We could imitate this two
pages
by having 2 "links syntax" pages in the user guide: basic and advanced.
Can someone here add this page
to the user guide structure so I can start the work?
The thing with using the first !header to display a page name is that it forces us to never use other first level headers in the page, and the result in the maketoc module is not really sensible. Why should the page title not be its name? Or the page description can be used for a slightly more evolved title, why the need for a third title system?
About my other questions related to the french translation I'll go directly ask the people who did it. An alternative set of french pages aimed to be a user guide was writen before the new structures appeared, it has no reason to be so anymore.
oliv'