5 ms·

Here is the exact opposite point of view, that we need massively more comments to the point where they are not merely comments, but comprehensive, prose discuss

Here is the exact opposite point of view, that we need massively more comments to the point where they are not merely comments, but comprehensive, prose discussion interwoven with code. As far as arguments to change the status quo go, I think Knuth's has more to recommend it: http://www-cs-faculty.stanford.edu/~uno/lp.html http://www-cs-faculty.stanford.edu/~uno/lp.html

seanmcdirmid 13y ago
After looking at the source code for Tex, I have decided literate programming is a massive failure.
- _delirium 13y ago
  I think TeX in particular somewhat suffers from being written in a language few people know (a Pascal variant Knuth invented) and to 70s architectural standards (fixed buffers for everything, etc.). Better recent examples: https://news.ycombinator.com/item?id=5998580 https://news.ycombinator.com/item?id=5998580 http://www.haskell.org/haskellwiki/Haskore http://www.haskell.org/haskellwiki/Haskore and just about anything in http://coffeescript.org/#literate http://coffeescript.org/#literate