News for hackers. Stuff that matters.
Re:Ask HN: Why did literate programming not catch on? by mkozlows on Sunday August 16, 2015 @05:04PM (#10070256)
Others have already given the reasons about the downsides of comments. One other reason is: Most developers are terrible, terrible writers.

It's one thing to imagine a profession of literate programming as practiced by Donald Knuth; it's another thing entirely to imagine it as practiced by the kind of people who are actually writing code.

Re:Ask HN: Why did literate programming not catch on? by sklogic on Monday August 17, 2015 @04:28AM (#10071834)
I always thought that people who cannot adequately express their thoughts are fundamentally unfit for any kind of programming anyway.