> The online manual is, as I said, an extremely useful resource. All I > am saying is that a more book-like-structuring (Introduction, > Chapters, Sub-Sections, Index etc.) would, just visually, help easing the > learning curve.
I'm completely with you. Unfortunately, there are also elements that favour more the "search-don't-sort" approach, and find tables of contents and indexes old-fashioned and "un-cool". > For example, a Table of Contents of the whole manual should always be > available. Isn't that the case at http://qooxdoo.org/documentation/0.8 ?! > I think the "Book of Dojo" is a good example: > http://www.dojotoolkit.org/book/dojo-book-1-0 It is also visually very > pleasing. Yep, certainly something I could live with. > As I said, don't understand this as nagging, just > suggestions, No worries. > since currently I am not contributing myself to change the > situation. What I would find cool is if the manual would be a > qooxdoo application itself, just like the API viewer.... C. I understand this sentiment, and there has been some consideration about this in the core team. And although it is certainly doable, I personally feel it would be brushing qooxdoo against the fur. qooxdoo is about RIAs, and a manual is not your prototypical RIA. I'd rather use an off-the-shelve CMS that gives me one-push PDF generation out of the box. And the whole thing is also about document maintenance, revision control, managing roles, handling comments, asf. asf. I think we have better things to do than re-inventing the wheel here. T. ------------------------------------------------------------------------------ Come build with us! The BlackBerry(R) Developer Conference in SF, CA is the only developer event you need to attend this year. Jumpstart your developing skills, take BlackBerry mobile applications to market and stay ahead of the curve. Join us from November 9 - 12, 2009. Register now! http://p.sf.net/sfu/devconference _______________________________________________ qooxdoo-devel mailing list qooxdoo-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/qooxdoo-devel
