Hi Chris, definitely like your doc layout. Could you make a bug out of it?! Just dump your suggestion into a comment.
Thanks, Thomas > > > What I would personally suggest is to reorganize your wiki docs to > take the view of someone coming to qooxdoo for the first time. Make > the main heading sections be things that new users will want to > 'discover' and then give them a good portion of "why" things are done, > before dumping them into the lower levels of "how" they're done. > > This is just a rough idea -- I don't know enough of all the system > details to make an accurate list... > > * Get all the document detail wiki pages up and working > (http://qooxdoo.org/documentation/0.8/) in their current layout > state. > > * Identify "Areas" of functionality, that need a higher level set of > documentation. These Areas could be things like: > > o *qooxdoo Quick Start - Installing the SDK* /and getting your > fist app runing./ > + The ideas and concepts behind qooxdoo > + Unix-like installation & setup > # Standard or SVN > + Windows installation & setup > # Standard or SVN > + Mac OSX installation & setup > # Standard or SVN > + Hello qooxdoo World > + Simple Stand Alone app (a full qooxdoo based > "desktop-style" app) > + Simple Inline app (adding a small qooxdoo app to an > existing html web page) > o *The qooxdoo Generator* > + An overview of how to generate your apps with qooxdoo > + The different types of applications you can generate. > + The organization of a generated qooxdoo project - what > goes where, and why. > + ... > o *Unit Testing* /how to help make sure your apps work/ > + The idea behind Unit Tests. > + How to add and use the qooxdoo Test Runner in your app > + Intermediate Testing > + Advanced Testing > o *Debugging & Profiling* > o *OO Programing */with qooxdoo/ > + All the Class, Interface, Mixin stuff here. > o *GUI Development* > + Widgets > + Layouts > + ... > o *Events* > o *AJAX* /server communication/ > o *Custom Widgets* /customizing qooxdoo and skinning existing > widgets./ > o *API Browser* > o *Demo application browser* > o *qooxdoo libraries* /user contributed additions to qooxdoo/ > o ... > > > Two things here; > > 1. The first is that you're organizing this documentation from a > complete qooxdoo "noob's" point of view, by starting with the > points that are the most relevant for them. So the concept of the > wiki documentation overview page would be Novice -> Expert as you > move down the page. > 2. The second is that I think that you have a good deal of this > information already. It needs to be updated for qooxdoo 0.8 > (obviously) and some more in depth "How to do things" articles, > that cover both the basics and in-depth details for more advanced > users. > > > Just my 2 cents as a qooxdoo noob myself :-) . > > Cheers, > -Chris > > > > > > > > > > > > > > > > > > > > ------------------------------------------------------------------------ > > ------------------------------------------------------------------------- > This SF.Net email is sponsored by the Moblin Your Move Developer's challenge > Build the coolest Linux based applications with Moblin SDK & win great prizes > Grand prize is a trip for two to an Open Source event anywhere in the world > http://moblin-contest.org/redirect.php?banner_id=100&url=/ > ------------------------------------------------------------------------ > > _______________________________________________ > qooxdoo-devel mailing list > [email protected] > https://lists.sourceforge.net/lists/listinfo/qooxdoo-devel > ------------------------------------------------------------------------- This SF.Net email is sponsored by the Moblin Your Move Developer's challenge Build the coolest Linux based applications with Moblin SDK & win great prizes Grand prize is a trip for two to an Open Source event anywhere in the world http://moblin-contest.org/redirect.php?banner_id=100&url=/ _______________________________________________ qooxdoo-devel mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/qooxdoo-devel
