Let me throw out some ideas, which Bob and I have discussed in the past and also mentioned here on osg-users...
* The reference manual, as it stands today, contains some nice supplementary material, but in essence it's Doxygen output from the source code. We could beef up the source code comments for classes and functions, and contribute this back to osg-submissions. This would improve future versions of the ref man. This is a big job and seems worthwhile only if we focus our efforts on stable functionality. * The existing ref man documents osg, osgDB, and osgUtil. We could expand this series to include similar reference material for things like the NodeKits (osgText, osgSim, osgParticle), using OSG in windowing systems (osgViewer, osgManipulator, osgGA), etc. * We could embark on the much-promised and long-awaited "Programming Guide". Again, this is a big job and only seems worthwhile if we focus our efforts on stable features. * We could spend time writing short whitepapers on various OSG topics, similar to Don's useful document on reference-counted memory. We could sell these as PDFs for a couple dollars a pop or something, depending on scope. Possible topics would include rendering order with RenderBins, deriving your own Nodes, Drawables, or StateAttributes, platform-specific topics, resolving build and installation issues, using the Geometry class, performance issues, etc etc, the list is essentially endless. * Any other suggestions for documentation? Paul Martz Skew Matrix Software LLC http://www.skew-matrix.com 303 859 9466 > let me pile on and say i'm thrilled we're done with this too. :) > > i'd also ask of all those users out there who are interested > in better documentation to send us an email: > [EMAIL PROTECTED] - tell us what would is most important to > you in our next book. what you'd like to see, what you think > needs more elaboration, etc. > > we're very interested in ensuring that these books are > relevant, focused, and good, and that we increase overall > goodness of the documentation and tools available to osg users. > > thanks! > bob > > _______________________________________________ > osg-users mailing list > [email protected] > http://lists.openscenegraph.org/listinfo.cgi/osg-users-opensce negraph.org _______________________________________________ osg-users mailing list [email protected] http://lists.openscenegraph.org/listinfo.cgi/osg-users-openscenegraph.org
