Just a suggestion, but for somebody just wanting to read through the
online documentation, a link to the Next and Previous pages in the
documentation would be convenient. Right now, I have to keep jumping
back to the documentation TOC just to go to the next section. To be
consistent with reading through a paper manual (shiver!), jumping
forward page-by-page would be an easy way to get familiar with all the
Qooxdoo concepts, which is probably more important for newer users than
current users looking for a particular detail.
Of course, I don't see anything like an Index page, sorted
alphabetically by keyword. This would be helpful when you want to find
a topic without remembering which "chapter" it's in, and might help to
reduce the number of "where do I find out how to..." questions on this
list. I envision keywords like "root", "widget", "dom", "object-
oriented", "create-application.py" etc. providing links to any chapters
that touch on that particular keyword, which might be a topic, concept,
language construct, or tool component. It can start out simple and grow
as contributors help add entries to the Index page. Even existing users
of the framework might find this really helpful in times of need. This
Index page link should show up on every page in the documentation, at
the bottom or top (or both), to facilitate finding an answer to a
question that comes to mind while reading.
Since I haven't really looked into the functional structure of the
Qooxdoo documentation, I don't know how easy it would be to implement
these types of features. A good example of a Next/Previous feature in
online docs is the PHP manual, which makes it really easy to just read
through the PHP docs linearly.
Any thoughts?
Thanks,
Gene
------------------------------------------------------------------------------
Apps built with the Adobe(R) Flex(R) framework and Flex Builder(TM) are
powering Web 2.0 with engaging, cross-platform capabilities. Quickly and
easily build your RIAs with Flex Builder, the Eclipse(TM)based development
software that enables intelligent coding and step-through debugging.
Download the free 60 day trial. http://p.sf.net/sfu/www-adobe-com
_______________________________________________
qooxdoo-devel mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/qooxdoo-devel
