Question

I have been using Git for some time now to manage my own personal projects. I didn’t really think about how I used it. I usually commit all the changes whenever there is a milestone not really thinking.

But after reading a blog post that mentions how you should right your commit messages, I realized that I don’t really know how to properly utilize SCM.

So I am wondering if you have any tips regarding things like:

• When you should commit a change
• How to write the commit message
• How to work with others using a repository
• anything else…

Thanks!

Answer 1

Since you’re using git, here are some of my practices that may or may not work for you:

1. Always work in a local branch with descriptive names, say work/feature_name (using the awesome bash completion for git to help you type)
2. Commit as often as you want in local branches with terse comments (to document intentions for reminding yourself.) So you have the complete original thought/development history that you can go back to.
3. Before you push/publish commits/patches, create a pu (proposed updates) branch (git checkout -b pu/feature_name) from your work branch and use git rebase -i to make perfect commits, i.e., group related small commits (and/or split large commits) in to logical commits and write meaningful descriptions (for others and yourself) make sure each logical commit builds and passes regressions.
4. Publish your pu/feature_name (either ask people to pull or just push to a public server like github.)
5. It’s likely you’ll need to iterate through 3 and 4 a few times if you have a code-review process.

It sounds complicated, but it’s really a joy to practice (at least for me), as git is so fast and feels so right in doing all these steps.