I try very very hard to write comments that I would want to read if I had to dive into someone else's code and understand what the hell it was doing and why.

@twylo I haven't commented code like that in a long time, and I need to get back into the habit.

We should start an organization, something like Fellowship of the Comment Block or whatever. You can only be a member if you can prove that you've written comments (or, alternatively, relevant off-line documentation that serves a similar purpose) above a certain minimum level.

It'd be like the Century Club in ham radio, but for code commenting. We can even have regular nets. 😉

@twylo it makes me unreasonably happy that your computer is still called motherbrain

Nice! What's your commenting style like where comments intermingle with lines of code?

Sign in to participate in the conversation
Mastodon @ SDF

"I appreciate SDF but it's a general-purpose server and the name doesn't make it obvious that it's about art." - Eugen Rochko