News for hackers. Stuff that matters.
Re:Literate programming tool for any language by fxn on Friday June 20, 2025 @10:30AM (#44328063)
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.

Re:Literate programming tool for any language by bluGill on Friday June 20, 2025 @10:38AM (#44328145)
Except that literate programming encourages that style by mixing comments with the code.
Re:Literate programming tool for any language by nothrabannosir on Friday June 20, 2025 @04:29PM (#44331781)
It 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”.