Clean Git History is Kinda Overrated
Tags: git, bestpractices, engineering
Published: 2020-05-11 11:38:45

---
title: Clean Git History is Kinda Overrated
published: true
description: 
tags: git, best-practices, engineering
---

An important thing I learned early in my career was that best practices should be followed with a pinch of salt. There are so many nuances to software development that a rule followed religiously doesn't take long to bite you in the back. It's not easy to realize that. Often, you read about an idea, you are sold to it (without considering its wider implications) and next thing you know, you're married to the idea. 

[Utility-first CSS](https://blog.usejournal.com/utility-first-css-ridiculously-fast-front-end-development-for-almost-every-design-503130d8fefc?gi=744de7f4cf79) is an example of this. Web developers are tied to the idea of 'separation of concerns' so  much that a framework like [TailwindCSS](https://tailwindcss.com/docs/) is generally perceived as the worst possible way to organize CSS. But, if you sat the concern aside for a moment, it doesn't take long to see the benefits. It clicked for me because I had the seen the struggle to modularize CSS or not repeating the same styles again and again.

I am always on the lookout for things we accept similarly and clean Git history appears to be one of them. 

How do I define a clean Git history? It's where each commit is a carefully separated, and each change is meticulously described, where you try to make sure that each change has its proper place (often using interactive rebase). 

Don't get me wrong. Clean Git history is useful and sometimes a necessity. In an open source project, if not for clearly scoped commits, releases would be a pain and so would be collaboration.

I am not advocating that your commit should be a massive change with a message "bug fixes." 

And I am specifically talking about proprietary software development which has fundamentally different dynamics than open-source. 

What I am bothered by is the the lengths developers sometimes go to make sure commits are 'perfect'. I see them interactive rebasing, editing commits, and moving them one above the other. Or more wastefully, taking lines of code in one commit, undoing it in that, and adding them to another commit, often leading to conflicts. The next thing you know you have wasted thirty minutes fixing your rebase. I see them fretting over how should they commit code, so the history appears like an elegant evolution of the feature.

Such efforts don't pass my rule of thumb for judging any best practice: did the time it saved exceed the time it took? A clean Git history, while sounds great in theory, is not really that useful for most teams, simply because you don't look at it that often. 

It has never been a big factor for me in trying to diagnose an issue or understanding part of the codebase. What has invariably mattered more is the current state of the codebase. When the code is clean and properly commented (though only [where it needs to be](https://blog.codinghorror.com/coding-without-comments/)), I have never felt the need to go through the history.

Yes, it's useful to just revert a commit if you break the build and it's easier to do something like `git bisect`, but a) it happens rarely than you think b) it's not a deal breaker if that option isn't available. 

I don't have a reason to believe that the time I have spent in abiding by strict rules regarding committing, solving Git-related problems because of that, was anything but a pointless exercise.

If let's say, I have to completely redesign a website, it's vastly better that I finish it off in one go than throw away my time thinking how to make my commit smaller. 

Granted this might be truer for rapidly moving software teams than, perhaps, Google or Amazon. But, having worked with a software team of 75+ people, I don't think it'll be every be a cause for a crisis unless the team size is exponentially more. Even then, just few rules around committing is more than enough. 

To reiterate, I am not disregarding everything related to committing changes, but only that - don't go overboard. Make meaningful commits with good messages, but you can do without unnecessary effort towards perfection. 

1. If you've created a big change that's too hard to break into individual changes, you're not committing a crime by creating a single commit and describe the changes in the description. 
2. Moving lines of code from one commit to another is time-consuming. It should be avoided as much as possible.
3. If you need to changes suggested in a code review, it's okay to create a fresh commit than trying to edit the old one using rebase. 
4. Commit description is a great feature to describe a change in more detail, but you should rarely be writing a whole thesis there.

What engineering teams need isn't strict rules, but guidelines. When the team is forgiving around what needs to be followed, it can move at a better pace without compromising too much.