News for hackers. Stuff that matters.
Re:Literate programming: Knuth is doing it wrong (2014) by WillAdams on Tuesday January 14, 2025 @08:16AM (#42696773)
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).

There are no comments on this comment yet.