3 ms·
PR descriptions/discussions, ADRs, and READMEs are often germane and useful, but the revision history itself? No, almost never. Any rationale motivating a piece
by sagichmal 7y ago
PR descriptions/discussions, ADRs, and READMEs are often germane and useful, but the revision history itself? No, almost never. Any rationale motivating a piece of code as it exists in the repo is, in my experience, best provided as a comment in-situ with the code. Information that's in the revision history but not in that kind of comment is, in my experience, historical noise.