Hi Robert, I guess as the creator of a well known open source project you are entitled to make claims about what all programmers should be capable of doing, but if the problem is that not enough people are contributing to the documentation, my first idea would be: try to make it easier to contribute, remove obstacles.
For example, I do know how to use repositories, but that doesn't automatically mean that I checked out the source of OSG trough your repository, I downloaded a stable version. So if I would want to contribute to doxygen or readthedocs I would still have to set up the repository connection for that reason alone, and to be honest (if we weren't having this discussion) I would probably have thought: "oh never mind then, that's too much work for making some small contributions to the docs". But still I understand the dilemma of keeping the docs in sync, so I think ReadTheDocs would be a good alternative because it would allow contributions to the docs in a structured/API manner without messing around with the actual source code, which I believe to be the most valuable addition at this point. ------------------ Read this topic online here: http://forum.openscenegraph.org/viewtopic.php?p=60895#60895 _______________________________________________ osg-users mailing list [email protected] http://lists.openscenegraph.org/listinfo.cgi/osg-users-openscenegraph.org
