I'm learning git and I've noticed that it has a two-step commit process:
git add <files>git commit
The first step places revisions into what's called a "staging area" or "index".
What I'm interested in is why this design decision is made, and what its benefits are?
Also, as a git user do you do this or just use git commit -a?
I ask this as I come from bzr (Bazaar) which does not have this feature.
Best Answer
Split work into separate commits. You've probably many times opened a file to write a single-line fix, but at the same time you spotted that the formatting was wrong, some documentation could be improved, or some other unrelated fix. With other RCSs you'd have to write that down or commit it to memory, finish the fix you came for, commit that, and then return to fix the other stuff (or create a ball-of-mud commit with unrelated stuff). With Git you just fix all of it at once, and stage+commit the single line separately, with
git add -iorgit-gui.Don't break the build. You're working on a complicated modification. So you try different things, some of which work better than others, some which break things. With Git you'd stage things when the modification made things better, and
checkout(or tweak some more) when the modification didn't work. You won't have to rely on the editor's undo functionality, you cancheckoutthe entire repo instead of just file-by-file, and any file-level mistakes (such as removing a file that has not been committed or saving+closing after a bad modification) does not lead to lots of work lost.