With dvcs/git, is a single commit preferred over multiple, small, thematic commits?

This may not be a git specific question, but it comes up in the context of git. The idea may apply more broadly to other vcs’s.

I am working on a small project in which I am currently the only developer. I’m getting used to using git, so I am wondering about best practices. As I implement new features/functions, I find that I work on multiple files, their examples, and documentation at once, such that my git status may report 15 files that have changed. But those files might relate to 3 different parts of the project.

  • What directory structure makes sense for DVCS such as git?
  • Describe your workflow of using version control (VCS or DVCS)
  • Will git push commits from all branches automatically?
  • Magento workflow process with git
  • That the reason to make harder work with anonymous branches in git (so named lost commits)?
  • Does any Version Control System like SVN, Git, or Mercurial let you “keep latest version” but not the revisions? (such as for binary files)
  • Is it better to commit them in 3 separate parts, keeping the related files together, so that I could later go back and more easily find those commits. Or it is just as easy to commit them all at once with an appropriate message?

  • git error: “fatal: not a valid revision”
  • Version Control for Graphics
  • Delete file on git repository
  • Deploy git subdirectory on heroku
  • Egit eclipse: resolve conflict without commit all files
  • TeamCity Visual Studio plugin with Git
  • 3 Solutions collect form web for “With dvcs/git, is a single commit preferred over multiple, small, thematic commits?”

    One criteria that can help you make the right “amount” of commit is git bisect or git blame: would a large commit be a nuisance when trying to git bisect in order to detect a bug?

    That is what describes the “Understanding the Git Workflow” blog post, when it describes “checkpoint commits” (too little commits capturing the code in a unstable state), or “no-ff commits” (which represents too many modification bundled together in one large commit).

    Its preferable to make commits atomic. That is, a commit represents one logical change to the project in question, and can stand alone.

    This allows

    1. Easy code inspection
    2. git bisect to work correctly

    It can be difficult, and there are many differing views about “the one best workflow”. Where possible it is better to

    1. separate concerns – use a number of short lived separate branches, one per concern. You can always squash your commit sequence before the final merge and publishing to a more senior branch.
    2. commit often – smaller steps make it easier to find where mistakes happened and why, and to align merges. Again you can squash after it works.
    3. use the staging area and git stash to partition which work you place in each commit.
    4. Don’t worry too much about minor slip ups. Foresight only happens if you walk backwards..
    Git Baby is a git and github fan, let's start git clone.