People definitely could stand to write a lot more comments in their code. And li... | Hacker News

Hacker Newsnew | past | comments | ask | show | jobs | submit

		dmoy 8 months ago \| parent \| context \| favorite \| on: Dijkstra On the foolishness of "natural language p... People definitely could stand to write a lot more comments in their code. And like... yea, textbook style prose, not just re-stating the code in slightly less logical wording.

hackable_sand 8 months ago | [–]

Yes exactly. Or like signposts on a road.

"You came from these few places, you might go to these few places, watch out for these bugbears if you go down that one path."

WillAdams 8 months ago | [–]

Welcome to the world of advocating for Literate Programming:

http://literateprogramming.com/

Guidelines | FAQ | Lists | API | Security | Legal | Apply to YC | Contact