then I realized (or read an article, idk) that comments should explain why you're doing something, not what you're doing. i think my comments got a lot better after that.
I think that's a pretty typical journey. Well, for those who arrive at the endpoint it's a typical journey. Many people never graduate from the 'do x' comment. One of my first bosses, the most talented guy I ever worked with, called this "commenting at the level of intent" which I always remembered.
In general, good writing is an art in itself - but that's not a surprise :)
Yup, you can write anything, no matter how boring, in a thoughtful, artful way. It's a superpower.
deleted by author
reply