Re:Literate programming: Knuth is doing it wrong (2014)
by hitchstory on Monday January 13, 2025 @12:10PM
(#42685766)
People leaving is a great reason to write literate tests and other kinds of docs - the kind people actually look for and want to read.
If somebody asks a question that can only be asked by looking in a commit message that usually represents a failure in one of those docs.
People leave projects/companies, people forget.
Code comments are also far from good. They have the same issue as duplicatet code. Comment and code age indiviually. Now you have to maintain both and it's for them to diverge.
Git commits are a snapshot of the codebase. Commit messages in them are pinned to a code version. Comments in commit messages are therefore always tied to the right version of code.