Comment by dmoy
15 days ago
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.
15 days ago
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/