@hellojed@mastodon.social @jk Oh, I'm totally down for "clean code," and I totally agree that maintainable code far outstrips the alternative. I'm suggesting that "readable code without comments" is still harder to maintain than "well-commented messy code" because well-commented code will tell me what it's trying to do, which lets me validate developer assumptions against software behavior. Code can't do that by itself. :)

@nicolai @hellojed@mastodon.social @jk I've heard this argument, too, and seen pros and cons to it. The comment history then becomes your Talmud. That's a fine approach as well, as long as you're consistent about it and people know that's where to look.

Sign in to participate in the conversation
Awoo Space

Awoo.space is a Mastodon instance where members can rely on a team of moderators to help resolve conflict, and limits federation with other instances using a specific access list to minimize abuse.

While mature content is allowed here, we strongly believe in being able to choose to engage with content on your own terms, so please make sure to put mature and potentially sensitive content behind the CW feature with enough description that people know what it's about.

Before signing up, please read our community guidelines. While it's a very broad swath of topics it covers, please do your best! We believe that as long as you're putting forth genuine effort to limit harm you might cause – even if you haven't read the document – you'll be okay!