Git is a free and open source distributed version control system designed to handle everything from small to very large projects with speed and efficiency.
Resources
Rules
Git Logo by Jason Long is licensed under the Creative Commons Attribution 3.0 Unported License.
YOLO! I like my commit history to tell a story of hope, defeat, pain, ennui, and triumph. A story filled with cursing and humor. The code is WHAT was done. Comments in the code are WHY something was done. Commit logs are for entertainment purposes, and for batching changes together in bite sized chunks to make PR reviews easier.
That's how I do it anyway...
Clean git histories are fun for the people who care, but they are also mostly useless.
I've been around a lot of arguments about the commit standards in teams and it's always boiled down to the "I don't care, but I don't want to spend time doing anything special" people vs the "do the things the way I like because I can think of three reasons it's technically superior but not practically useful to do so" people.
Bikeshedding at its finest
A great gain from a systematic approach of creating clean history is a better understanding and higher discoverability of issues.
Looking into change history is rare. But designing your changes, being deliberate, structured allows for easier and safer reviews and merges. And spotting issues early is always cheaper and better.
It also helps tremendously in determining what changed between versions. And when necessary finding and reverting regressions.
Cleaning up your history before making a PR can make it easier to review so I always try to do that, but it's not something that should be over done because it can quickly eat up more time than its worth if you go overboard
Doesn't squashing on merge achieve exactly the same thing? (As long as pull requests are kept small, of course.)
To a degree, if pull requests are small enough, then yes.
Often, a changeset includes different aspects and concerns though, and individual commit messages allow you to document and reason them. Squashing makes you lose the concern separation.
When reviewing, even relatively simple changes separated into their concerns helps me a lot.
It's a matter of preference and necessity, and the changeset and it's environment at hand.
Not squashing before review, squashing on merge (i.e. after review). Squashed merges make these easy, regardless of whether the original commits in the pull request were messy:
Yes, this is the
do the things the way I like because I can think of three reasons it's technically superior but not practically useful to do so" people.
Camp I was talking about. You've your reasons, you'll bikeshed about it for months and no one gets anywhere and no one is happy aside from the people that enjoy the arguments
I've never really needed to use rebase, but my workflow is probably kinda weird:
git checkout -b new_feature_branch, and so move my changes to a different branchgit reset head~10 meaning all 10 commits are reverted into staged changesgit push -f the new commit back to origin (of feature branch)It works pretty well for me, but I was told its weird, and I should rebase instead
The benefit with rebase is if you want to have maybe 4 commits insteadd of 10. When reviewing a large pr, I find that it's helpfull if it's broken up into a couple of coherent commits so that I can review it commit by commit. It's easier to follow the logic of why something is being changed if it's associated with a specific commit.
Sometimes squashing the entire commit is the right choice, in which case you can do what you're doing or use some built in feature to do that.
You do you. People generally discourage rebase because it rewrites history but that's what you're doing anyway. You can achieve the same result with revase --interactive and following the instructions to squash all your in progress commits into a single commit. That way you don't have to figure out how many commits between your in progress and dev(for your reset command) as the rebase will handle it for you.