Choose Your Commit Messages Properly
Join the DZone community and get the full member experience.Join For Free
how often did you take a look at the history of some file/folder ?? it's just the best backup system you could have and that's one of the main purposes of a vcs (forget about branching, merging etc for a while ). and if you did look at your commit messages, were they meaningful?? did they make any sense to you?? so often they don't, right? messages like...
- method 'somemethodinaclass' modified
- added some files
- fixed some bugs
instead...when looking at the 1st sample comment "method 'somemethodinaclass' modified", what would you think about this comment as a (more expressive) alternative:
now assume you're currently searching for an issue you're having related to the reading of some entities...i bet this message would jump on your eyes immediately!
so....the history excerpt from your vcs should nearly be something that you could directly copy and paste as a public version history on your webpage.
Published at DZone with permission of Juri Strumpflohner. See the original article here.
Opinions expressed by DZone contributors are their own.