← Back to context

Comment by macintux

8 hours ago

The code can only convey what is being done (and then, in some cases, only superficially). It can't convey what decisions were made, what alternatives were discarded, what business motivations may have led to that code.

And for old enough code, the author may not be available, or more likely doesn't remember.

Fine, but none of that is in a normal commit message, lets be real...

  • Which circles back to why it's important for leadership to tackle this

    • Yes, but not in the form of commit messages, the parent comment described things better suited to jira tickets, documentation etc.

      It feels like we're trying really hard to stretch the utility of commit messages here...

      5 replies →