Every story and comment from the Hacker News API, in a layout borrowed from 2001.
A comment on Documentation is for computers to read (or: Commenting Code is Evil). Parent comment
Take, as a counter-example, any of Knuth's literate programs. Do you really want to say he's doing it wrong?
Some things are that complex. And sometimes, the best way to make sure that the code is understandable is to add some human-readable text.
It's naive to think that humans and compilers should both be able to parse and comprehend the same text with the same ease.
There are no comments on this comment yet.
Take, as a counter-example, any of Knuth's literate programs. Do you really want to say he's doing it wrong?
Some things are that complex. And sometimes, the best way to make sure that the code is understandable is to add some human-readable text.
It's naive to think that humans and compilers should both be able to parse and comprehend the same text with the same ease.