I have recently been translating documentation pages into french and started to realize how messy things are.
There used to be a unique documentation structure:
Things seems to have started to evolve for the best with the creation of several different structures supposed to contain the same stuff:
Now we are stuck with two paralel systems which is confusing to say the least. So my main question today is:
Is the old “documentation toc” structure ready to disappear? If not, what still needs to be done?
In the spirit of splitting the guide for admins and users, I think splitting this page would be a good idea: http://doc.tiki.org/Wiki-Syntax+Links
In fact, it seems it has already been done somehow with http://doc.tiki.org/Wiki+Linking
The idea is to have a user centric page on how to create simple links, mostly via editing icons in the user guide structure, and keep the gory details for the admins in the “tiki reference guide” structure
Also, while translating I found out a few odd things, like different places for translated content in a structure.
For example, why is this not in this page ?
why is the content of this included here in the french version but not the english one? which is right?
At last, an OT note: I support the minor alternative layout modification proposed here:
The first paragraph of a page should not be the page title. The page title should be displayed above the page or the description made bigger.