There’s an old saw about software documentation:
Documentation is like sex; when it’s good, it’s very, very good, and when it’s bad, it’s better than nothing. –Dick Brandon
Clever quip, to be sure, but it glosses over a big time-sink that maintenance programmers (read: all programmers) have to contend with: wasting time believing in misleading or [...]
