How to write technical documentation

This is absolutely brilliant. If only we could all use this approach.

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.

[From How to write technical documentation...]

Comments

Got something to say?