News for hackers. Stuff that matters.

A comment on Ask HN: Why did literate programming not catch on?. Parent comment

Re:Ask HN: Why did literate programming not catch on? by ecthiender on Sunday August 16, 2015 @05:04PM (#10070255)
But isn't the point of literate exactly that? You keep your code and your docs (design, description etc) closely knit. So even if you need to change your software rapidly, you change your code and docs together.

PS: I'm trying to do literate for my full time programming, still trying to cross the hurdle.

[ Parent | on HN ]
Re:Ask HN: Why did literate programming not catch on? by ucho on Monday August 17, 2015 @03:53AM (#10071745)
> keep your code and your docs closely knit

It is hard. Most people I know try to replace comments with very descriptive variable and method names - that are easy to change in any IDE. On the other hand comments (and other docs) sooner or later turn into misinformation/lie, unless you have very disciplined developers, all of them.

[ Parent | on HN ]