On Thu, 10 Dec 2009, thron7 wrote:
site that I find really helpful. It's like a book with table of contents distributed all over the place (not many of these exist and usually there is more than just one level of hierarchy visible in the "main table of contents" at the beginning/end of the book. I don't know why this rather useful concept is suddenly overthrown on electronic media (just because you can also search, doesn't invalidate a proofen concept). Anyway ...I'm not sure I'm getting what you mean here. Are you talking about books whos table of contents is "distributed all over the place"? I'm not sure I've seen such a book.
That's exactly what I am trying to say ... most books have a toc at the beginning. Some have additional more detailed tocs in front of major sections/chapters.
On the Qooxdoo website my main difficulty is to find the right kind of documentation, mainly because there is so much of it. Right now I was trying t find the snippets area. Finally I found it via the search function and then realized that it is "hidden" on page » Home » Documentation » Manual x.x rather far down on a long page below "Other". I think such a long page with links to other pages makes it difficult to find relevant information (I at least knew already that "Snippets" exists).I'm thinking in just the opposite direction. I'd rather see the manual index page evolve into a full table of contents, hierarchical and with indentation, that links to every other page of the manual.
That doesn't really sound "opposite" to what I am trying to say ...
Then you had both a systematic organisation of all the material and you could use the browser search facility to look for key words on this page.
That would certainly be helpful/
Together with a word index (also book-like) I think this would be the best approach to get oriented and to find things.
Also helpful.
And it shouldn't be too hard to generate a PDF from that.
The potentially tricky part would be to get page numbers into the index (links won't work once printed). Cheers, Fritz -- Oetiker+Partner AG tel: +41 62 775 9903 (direct) Fritz Zaucker +41 62 775 9900 (switch board) Aarweg 15 +41 79 675 0630 (mobile) CH-4600 Olten fax: +41 62 775 9905 Schweiz web: www.oetiker.ch
------------------------------------------------------------------------------ Return on Information: Google Enterprise Search pays you back Get the facts. http://p.sf.net/sfu/google-dev2dev
_______________________________________________ qooxdoo-devel mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/qooxdoo-devel
