I need some help in making decisions. For the last few weeks i am busy updating the manual, for now, especially the structure.
Not all pages fit in one toc, so i splitted that in a second toc (advanced, FAQ's, Inner workings and Appendixes), although i myself would not mind one large toc. Whith one large toc you see immediately where you are in the manual and it is easier to maintain. What do you think?
During my reading of the manual i learned more about XBMC from pages i didnot see before. Some very interesting pages are hard to find so i brought them into the toc. In my opinion every page should be linked somehow to the toc. That way everyone knows to find it and you find it back again easier.
But, you cannot put every page in the toc, that will make it a mess too, especially with the HOW-TO-pages. So i made for some pages a 'GoTo button'. This way, when you surf out of the toc-structure, there is always a way to go back to that toc where you were before. It is a kind of browser back-button but in the same place as the toc and it brings you to the logical place in the toc, you don't feel lost. Here is an example: http://www.xbmc.org/wiki/?title=XBMC_9.04_Point_Release
There should be a kind of strong advice that tells you that a page should be in the toc or have a GoTo-button to a page that is in the toc. It is also a waste of good information (and our time) if the average visitor will most likely not see all the pages we all made.
Please let me know what you think of this.