Seven Rules for Sound Documentation
Posted by Ravikiran K.S.
on January 1, 2006
Documentation should be written from the point of view of the reader, not the writer.
Avoid unnecessary repetition.
Avoid ambiguity.
Use a standard organization.
Record rationale.
Keep documentation current but not too current.
Review documentation for fitness of purpose.