>I don't think it is necessary to keep 0.5 documentation *within* the new
>documentation structure. Newcomers will use 0.6 and the new
>documentation. For the "old generation", keeping (!) the existing
>documentation in a different location where bits and pieces can be added
>is enough. People who are still with '"the old ways" probably know the
>code well enough by now and do not need general introduction.
>But PLEASE keep the old 0.5 documentation and do not just update them !!!

This is what I find interesting, in that...There are less than ten total pages of information currently on the site for 0.5 .  I literally wrote out on paper a tree of links and it was a 2 x 9 grid of pages, most of which was just snazz and pizazz about why you should use qooxdoo.  I think a "pre 0.6/namespaces" section on the wiki would do nicely.  The structure of the documentation page will then become:

- The official qooxdoo howto
- FAQ
- Tutorials
- Pre 0.6 qooxdoo  (If you want a better name for this section like "Legacy qooxdoo" let me know)

This would have the benfit of allowing those who wish to maintain that documentation the freedom to have a separate structure that doesn't impact the 0.6 efforts.  It can be a more familiar format for them, rather than turning the whole site on it's head from their perspective.

Sebastian, I had a look at the front page after I made some changes and indeed it bugged me that the links were red.  Looking right now, it appears as though they have been updated to reference the howto.  This is good for now and in the future, when a "big buzzy advert page" is made, additional links can be made that conform more to the selling points of qooxdoo maybe even some screenshots and links to demos/tutorials.


_________________________________________________

    Alexander Trauzzi
-------------------------------------------------------------------------
Using Tomcat but need to do more? Need to support web services, security?
Get stuff done quickly with pre-integrated technology to make your job easier
Download IBM WebSphere Application Server v.1.0.1 based on Apache Geronimo
http://sel.as-us.falkag.net/sel?cmd=lnk&kid=120709&bid=263057&dat=121642
_______________________________________________
qooxdoo-devel mailing list
[email protected]
https://lists.sourceforge.net/lists/listinfo/qooxdoo-devel

Reply via email to