Resources for creating useful revision histories
Talks
A Branch in Time: This talk is my canonical primer for better understanding the immense power of revision histories whilst also learning the practical techniques for creating them.
Get Off the Tightrope by Tom Stuart: A great talk from Tom Stuart in which he outlines remedies and strategies for dealing with large problems, including advice on how history hygiene can help. Highly recommend.
Telling Stories Through Your Commits by Joel Chippindale: Another great talk, this time from Joel Chippendale of Future Learn covering similar ideas to those covered in my talk.
Git-driven Refactoring: Ashley’s talk from Brighton Ruby is a fantastic talk that demonstrates some of the other benefits that can come from a well put together revision history.
Blog posts
I have an ever-expanding series of blog posts about Git, which you should totally read. But beyond that, check out these classic posts from others:
A Note About Git Commit Messages by Tim Pope: This for me is the canonical blog post on how to write good commit messages. Essential reading.
Small Commits for Fun and Profit Part 1
and Part 2: Two fantastic blog
posts that detail how to shape commits using git add
--patch
, git commit --amend
and git rebase
--interactive
.
How to Write the Perfect Pull Request: Another great blog post on putting together the perfect pull request by Keavy.
Every line of code is always documented: Mislav’s post was instrumental in my understanding of the usefulness of a well put together history and the ways Git can be used to dig through one.
Other resources
Flight rules for Git: A comprehensive and succinct primer containing step-by-step actions for performing common Git actions.
Git Ready: Includes a breakdown of beginner/intermediate/advanced Git techniques, useful if you’re looking to learn something new to level up your Git abilities.
GIT.WTF!?: Similar to the flight rules, full of tips covering common problems and questions people face when working with Git.