> The lack of internal documentation is an issue for many of not most > open source projects. One reason for this is that it is a big > undertaking to completely document a system of the complexity of FG. > > > For example I just "finished" (meaning that it is good enough - not > that it is perfect) documenting a Class for another project. This was > a relatively simple class with about 22 methods. I spent the better > part of a week's full time effort to document it and I wrote the code > so I knew what it did before I started working on the documentation. I > have not looked at the FG internals but I would guess that it has > hundreds of Classes and many of these are likely more complex than the > one I just documented. So writing detailed internal documentation for > FG would probably keep some one occupied full time for the better part > of a year. > > > In the long run having this documentation would help the project but > it is a huge undertaking. In addition, it is an undertaking that has > little if any short term impact on the project which makes it even > less attractive for potential contributers. > > > Hal
Well, I tell not only about a documentation, but about some common plan, some clear inner structure not only of project itself but community too, and so on. I may be wrong and may be some consolidation is not needed. It's all may be only my conjectures. If people get fun and all goes well right now, and there is no future problems emerges by next corner then it's all ok. I do not want You change everything only because some guy can not get his fun. But if not then not. So lets count that issue fix time changes. It's gotta be not so big problem what could take less than hour to see. ------------------------------------------------------------------------------ Got Input? Slashdot Needs You. Take our quick survey online. Come on, we don't ask for help often. Plus, you'll get a chance to win $100 to spend on ThinkGeek. http://p.sf.net/sfu/slashdot-survey _______________________________________________ Flightgear-devel mailing list Flightgear-devel@lists.sourceforge.net https://lists.sourceforge.net/lists/listinfo/flightgear-devel
