robertosfield wrote: > When authors move on, the bucks stops with me > > The issue of knowledge about code base become especially difficult when the > original authors have moved on from the project as it falls on me to become > the sole expert, not because I want to be, but because if no one else steps > up it won't get done. The situation of orphaned modules is one of the most > challenging ones for me. Modules where this particularly difficult is > osgIntrospection/genwrapper, and to a lesser extent osgManipulator, osgFX and > osgParticle. > > Plugins also present a stretch for me as it's not unusually for these can > also become orphaned, for plugins that aren't used heavily or are > straightforward it's not so much hassle as a code review can be enough to get > one up to speed. However, plugins like txp are rather daunting.
Perhaps there should be an enforcement of better commenting standards on submitted code. This might reduce the load of questions being asked by the community as they can understand the code better and increase the amount of users who can answer them effectively. Obviously the tricky part is how much better is "better" and what is "good enough?" That can be another discussion. Also, if the user/developer base is more informed of the codebase, you can also have more people who can process submissions Another question arises, how do we better comment/document the current code base we have now? Well that can be up to the community, you can let it be known that OSG is currently looking to improve its documentation and users who find themselves stepping through code to understand various sections, to take the time (time they are already spending walking through and tracing code) and add comments where needed (preferably the parts that confused them). I know for myself, when I was trying to learn some parts of the code, thought that some parts could have been documented better. The OSG quickstart guide was very helpful in my understanding of OSG. These ideas may be logical, but I'm not sure on the practicality of it all. This is my first open source project and biggest project that I have worked with to date, so I may be out of my league and for that I apologize. :P Good luck with your investigation :) Nick ------------------ Read this topic online here: http://forum.openscenegraph.org/viewtopic.php?p=24659#24659 _______________________________________________ osg-users mailing list [email protected] http://lists.openscenegraph.org/listinfo.cgi/osg-users-openscenegraph.org
