My eleven tips for writing more useful systems documentation
A common complaint in most tech teams is that documentation is imcomplete, out of date and generaly the documentation that is there is useless. Quite often you hear people say "old documentation is worse than non documentation at all," "we need more documentation," "we need less documentation," or even "the system should document itself."
The following is a few techniques I have found useful in the past for making sense of documentation.