git-ready 1.0.2

Traditional, branch-based git workflows are effectively anti-social when combined with social code review tools, like Gerrit, where the philosophy of an effective contributor is to share code early and often, long before it’s in a “mergeable” state.

Branch-based workflows presume that you are a lonely contributor, working on an island, and that someday your commits will be mature enough to set sail for civilization. Perhaps your commits are flawed, but that’s okay, because they’re still private. You’ll have time to clean them up later. No one has to see your dirty shortcuts or your “obvious” mistakes.

Local branches ultimately foster offline iteration, void of human interaction, where you can dwell on syntactic sugar, admiring the beauty of your art. Confidently bolstered by whole days (or even weeks) spent in isolation, you finally venture into the land of open source, only to have your masterpiece shot down: “PEP8 violation. Did you even submit a TPS report?”

Instead, don’t create local branches at all. Do a bit of work and kick it off to Gerrit. Maybe it’s still a work in progress, maybe it’s not. The important part is that code review is an important feedback loop, and you should do everything in your power to tighten your feedback loops. Developers communicate to each other in code. Share your commits as early as possible. Get that inevitable feedback sooner.

Communicate more; iterate faster.

git ready fosters a social workflow, where you have no chance of accidentally committing directly to master, and your best means of tracking your work is to share it in Gerrit.

Installation

From PyPi:

$ pip install git-ready

$ git clone git@github.com:openstack/nova.git
$ cd nova/

$ git ready

$ git commit

$ git review

$ git ready
$ git commit
$ git review

$ git ready stable/release
$ git commit
$ git review