Friday, 3 February 2006


Taming the dragon

Occasionally I wonder whether I should go into technical writing.

That feeling's never stronger than when I read an absolute gem. Take for example Apple's description of the notoriously compex Kerberos protocol:

A Kerberos ticket is like a press pass to a jazz festival held at multiple nightclubs over a three-day weekend. You prove your identity once to get the pass. Until the pass expires, you can show it at any nightclub to get a ticket for a performance. All the participating nightclubs accept your pass without seeing your proof of identity again.

If you've been wading through technical documentation all day, to stumble across a paragraph like that is a joy. And isn't that the impact we all want our work to have on others?

Posted by pab at 11:54 | Comments will be back later in the year. Please email me instead!