Open Source Documentation Weaknesses - TechRepublic
General discussion
February 5, 2009 at 11:55 PM
hramsdell

Open Source Documentation Weaknesses

by hramsdell . Updated 17 years, 5 months ago

Over the years it seems like there have been many articles about the bane of open source development being the limited documentation. Is this still the case? I’ve been having a hard time finding quality documentation for many systems.

So I somewhat took the developer mentallity and decided to do it myself. The company I work for has recently started documenting in extensive detail open source systems including Azureus, Eclipse, JUnit, JBoss, and hundreds of others. We are looking for feedback and suggestions on the types of diagrams, models, metrics, etc. that would be useful to you all as developers of this system. Currently we include a number of software engineering methodologies include UML, MDA, OOA/OOD, SSADM. There is also complexity indexes and details of unused/dead code. Please take a look and give us some honest feedback.

If anyone would be so kind as to help get the word out. We’d love to open up the flood gates for more organizations to use open source software.

http://www.softwarerevolution.com/portals/

Thanks!

Howard Ramsdell
Software Engineer
The Software Revolution Inc.

This discussion is locked

All Comments