How to write technical documentation...

Jeff Moser has written an excellent article describing how the Advanced Encryption Standard works.  He uses an very accessible paradigm - the cartoon.  He layers the description starting with a simple overview and progressively getting into more and more detail.  Because the story is layered, it is complete at each stage before more detail is added.   The audience has the opportunity to leave when they know enough. 

Comments

[Ryan Schellenberg]

Very clever find. I love the way it builds from the very simple to the complex slowly, and, as you said, the audience has the opportunity to leave when they know enough.