Release Process


Since version 1.0, Patchwork has implemented a version of Semantic Versioning . To summarise, releases take the format MAJOR.MINOR.PATCH (or just MAJOR.MINOR). We increment:

  1. MAJOR version when we make major UI changes or functionality updates
  2. MINOR version when we make minor UI changes or functionality updates
  3. PATCH version when we make make bug fixes, dependency updates etc.

In Git, each release will have a tag indicating the version number. In addition, each release series has it’s own branch called stable/MAJOR.MINOR to allow backporting of bugfixes or security updates to older versions.

Release Cycle

There is no cadence for releases: they are made available as necessary.

Supported Versions

Typically all development should occur on master. While we will backport bugfixes and security updates, we will not backport any new features. This is to ensure stability for users of these versions of Patchwork.

Release Checklist

  • Documentation has been updated with latest release version

  • Documentation references latest supported version of Django

  • ‘alpha’ tag has been removed from __version__ in patchwork/

  • Commit has been tagged with an annotated tag. The tag should take the form v[MAJOR].[MINOR].[PATCH], e.g. v2.0.1. The message should read:

    Version [MAJOR].[MINOR].[PATCH]
  • A GitHub Release, with text corresponding to an abbreviated form of the release notes for that cycle, has been created

The following only apply to full releases, or those where the MAJOR or MINOR number is incremented:

  • A new branch called stable/MAJOR.MINOR has been created from the tagged commit

Once released, bump the version found in patchwork/ once again.


We will occasionally backport bugfixes and security updates. When backporting a patch, said patch should first be merged into master. Once merged, you can backport by cherry-picking commits, using the -x flag for posterity:

$ git cherry-pick -x <master_commit>

There may be some conflicts; resolve these, uncommenting the Conflicts line when committing:


When enough patches have been backported, you should release a new PATCH release.