Wednesday 20 November 2013

Software documentation rot

When your tools don't work, you stop using them. This is a problem with software documentation in particular - a kind of Catch-22 situation. If the documentation is out of date or inaccurate, nobody refers to it. If nobody is referring to it, then nobody bothers to update it. So software documentation naturally tends towards chaos and particular software expertise tends to migrate to people's brains instead of documents.

Mokalus of Borg

PS - If you still need to do the same job, you must get better tools.
PPS - Quite often, better tools just don't exist.

No comments: