> 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.

> 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. 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. Together 
with a word index (also book-like) I think this would be the best 
approach to get oriented and to find things. And it shouldn't be too 
hard to generate a PDF from that.

T.

------------------------------------------------------------------------------
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

Reply via email to