Mark H Weaver <m...@netris.org> skribis: > Our conventions for commit logs, which follow the GNU Coding Standards > for Change Logs (see section 6.8 of the GNU Coding Standards), is that > explanations belong in the comments of the code itself, not in the > commit log. If that had been done in the example you give above, you > would have known why the line was needed in a small fraction of the time > that it must have taken you to perform all the steps above. > > However, I agree that commits that _remove_ code should include the > rationale in the commit log, if the reason is not obvious and if there's > no sensible place to put the explanation in the code. > > What do you think?
+1 Ludo’.