Author archive

How to write really good documentation: Donald Knuth was wrong

Donald Knuth was wrong.

While it’s true we still need ‘better documentation of programs’ it isn’t true, or it is no longer true, ‘that we can best achieve this by considering programs to be works of literature.’

Huh?

» Read more


How to write really good documentation:Semi-definite rules for the indefinite article

Here’s an easy way for a writer to start an argument with me, an editor. » Read more


How to write really good documentation:
Four rules and an axiom

The question came in via IRC.

» Read more


How to write really good documentation

Documentation doesn’t matter. After all, no one reads the manual, right? Wrong.
» Read more