Wednesday, July 18, 2007
Calculating Documentation Cruft
There's a new (13 July 2007) article over at Dr. Dobb's Agile Modeling Newsletter portal, titled Calculating Documentation Cruft
Here "cruft" is designated as:
At the bottom of this newsletter there are also some very useful hot links to other agile documentation strategies and approaches, including the following one for general issues surrounding communication.
Here "cruft" is designated as:
- C = The percentage of the document that is currently "correct".
- R = The chance that the document will be read by the intended audience.
- U = The percentage of the document that is actually understood by the intended audience
- F = The chance that the material contained in document will be followed.
- T = The chance that the document will be trusted.
At the bottom of this newsletter there are also some very useful hot links to other agile documentation strategies and approaches, including the following one for general issues surrounding communication.
Labels: Architecture, Communication, Documentation, Web Design
