In my own current project I've found that it's important to remember that there are at least two different audiences for the documentation: - the user who want

In my own current project I've found that it's important to remember that there are at least two different audiences for the documentation: - the user who wants the bare minimum, perhaps a template and a brief discussion of each command, ideally wrapped up to be as friendly as possible - myself and other programmers who want the innermost workings explained in detail The typical user of TeX doesn't want _The TeXbook_, nor even a Literate version of Plain TeX (and why that doesn't exist is a different discussion), but rather lshort.pdf (and they _don't_ want the typeset .dtx source of latex2e --- I actually printed that out once, and have yet to read it, since I still need to compile a list of texts I need to read/concepts I need to understand in order to do so profitably).