Rather than rant get off your arse, the website is a wiki YOU YES YOU can help arrange and contribute things.
On 8/22/07, mkg <[EMAIL PROTECTED]> wrote: > The best kind of code documentation, for me at least, has always been > annotated online demo code, such as NeHe's OpenGL walkthroughs and > Irrlicht3D's online tutorials: > http://nehe.gamedev.net/ > http://irrlicht.sourceforge.net/tutorials.html > > The main problem with OSG's documentation isn't that there's not enough > of it, but that it's poorly presented on the website. You have to click > twice before finding the tutorials page, and then you're presented with > an undifferentiated forest of links that happen to include Joseph > Sullivan's excellent set of easy-to-browse tutorials, along with other > people's random mystery tarballs. > > Contrast this with irrlicht3d's presentation (see link above), where > there's one official tutorial page, linked directly off the main page, > with thumbnails for each tutorial. > > What would be best, in my opinion, is to get rid of that splash page > (!), and on the main page have the sidebar display "Downloads", > "Tutorials", "API", and "Other references" explicitly, at the top. I > would get rid of the first 6 items in the current sidebar and just move > them to the "About" page, because most people don't care (sorry) about > things like "Introduction" and "History". The tutorials should all be > webpages rather than tarballs, and be indexed with thumbnails on the > tutorials page, in rough order of difficulty (Joseph Sullivan has it > right). Oh, and why is there a splash page?? (Okay, ending rant.) > > *Wheeze, wheeze,* > -- Matt > _______________________________________________ > osg-users mailing list > osg-users@lists.openscenegraph.org > http://lists.openscenegraph.org/listinfo.cgi/osg-users-openscenegraph.org > _______________________________________________ osg-users mailing list osg-users@lists.openscenegraph.org http://lists.openscenegraph.org/listinfo.cgi/osg-users-openscenegraph.org
