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

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.


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."


Welcome to the world of advocating for Literate Programming:

http://literateprogramming.com/




Consider applying for YC's Summer 2026 batch! Applications are open till May 4

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

Search: