2 ms·
That is not the hallmark of literate programming, but the hallmark bad/unhelpful code comments or docs. Like, you can also have bad/unhelpful function names or
by fxn 1y ago
That is not the hallmark of literate programming, but the hallmark bad/unhelpful code comments or docs. Like, you can also have bad/unhelpful function names or unclean and tangled implementations.
"TeX: The Program" is a joy to read.
- bluGill 1y agoExcept that literate programming encourages that style by mixing comments with the code.
- nothrabannosir 1y agoIt doesn’t. Literate programming is letting the documentation, rather than the implementation, dictate the order and organization of the program. You could theoretically write a literate program that is nothing but code, if the code is so readable that it doesn’t need explaining. The distinction is that it is “human first” over “computer first”.