> We should give move people write access to the cvs. Maybe each user > shuld be able to check in fixes and documentation. > I think for the core team it is easier to check the changes than doing > all the work alone. And contributing documentaiton > could encourage people to contribute new features. > > Marcus > Maybe thats not such a bad idea, though probably not every user should have access, but maybe those who use it reasonably long and intense (though that might be hard to evaluate). I use OpenSG since some months and I wouldn't really dare to document it, besides some basic stuff.
But what is definitely true in my opinion, is that OpenSG needs nothing more than a good documentation. I mean why have descent new features if no one knows that they exist and how to use them. For me learning OpenSG was the hardest graphics API, besides OpenSceneGraph (wich I cancelled quite fast, also due to bad documentation), and not so much intuitive. The only helping document is the StarterGuide wich doesn't go so deep actually. And though I know OpenGL quite well, I can't agree that it helped much to learn OpenSG. If I need a special functionality I keep searching the Doxygen Doc until I accidently find something that might be right and then ending up reading the source code of that method to understand whats happning. Can't be the way :-/ So if some key users (and well the developers would be great too :-) ) begin to document the code on an organized base, maybe OpenSG will become much easier to use. And hearing a developer saying that documentation is a waste of good developement time is kinda sad. I mean an API normaly is made to be used by others, so a main goal should be to make it usabable and it doesn't really take long to write a few lines above every method, just need to get used to it :-) And I think OpenSG was initiated at a university and I don't know any university where they don't teach you the importance of software documentation ;-) So far my opinion, I'm curious about the things to come. Michael PS: QT's documentation really rocks ...well but they earn money with it ... ------------------------------------------------------------------------- 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 _______________________________________________ Opensg-users mailing list [email protected] https://lists.sourceforge.net/lists/listinfo/opensg-users
