Slashdot Mirror


Software Documentation Standards?

CynicTheHedgehog asks: "I am a programmer for what used to be a small CLEC in the Southeast. Initially I was in charge of system administration and development of small PHP scripts under little supervision and absolutely no quality control. I now work with an entire team of developers under new management, and recently there has been a major push toward mature development practices, not least of which is project documentation. The problem I am experiencing is that up to this point each of us was in charge of his respective projects, more or less managing them from conception to completion. That being the case, the documentation solutions we have come up with have been something of a mix between technical specifications and your typical corporate red tape. Our processes are poorly defined at the moment and I'm trying to come up with a solid, standards-based documentation solution. An SRS is a bit heavy for what we're trying to do and doesn't provide the 'sign-off' points we need to cover our rears. What kind of documentation formats are in place at other companies? Are there any defacto standards in the open source community that are useful in a corporate context?"

0 of 11 comments (clear)

No comments match the current filter.