Skip to content
CONTACT

Law of posthumous documentation

PROGRAMMING AND BUGS

Documentation, when it exists, describes the previous version of the program with great precision.

— Anonymous, computing folklore
VIDEO.EXE16:9

Technical documentation is a literary genre of its own, halfway between the historical novel and the last will and testament. It describes in loving detail a world that no longer exists: buttons that have moved, menus that have been renamed, features removed in the meantime during a four-minute meeting.

The reason is simple. Code runs, documentation walks. By the time someone finally writes the manual for version two, the programmers are already arguing about version four.

I have a client who keeps the manual for his management software in a display case, like a relic. Every now and then he opens it and reads the instructions aloud, solemnly. None of them matches the screen any more. But he says it helps him remember what the world was like when the buttons were on the left. And frankly, I understand him.