A Philosophy of Software Design

by John Ousterhout

When writing a commit message, ask yourself whether developers will need to use that information in the future. If so, then document this information in the code.