Perl Debugged

3.4. Documentation

We know, real programmers don't document. “It was hard to write; it should be hard to understand.” We feel your pain. However, the sanity you save may be your own. You could hop between jobs sufficiently rapidly that you never have to revisit a program you wrote more than six months ago.^[2] Or you could document it so you'll understand what you did.

^[2] But if you never write programs for your personal use, you can't consider yourself a true programmer.

Reams of valuable material have been written on the subject of program documentation, most of it by people who aren't programmers or who would be considered fringe programmers at best by people who think of themselves as “real” programmers. If documentation is your nemesis, we ...