aboutsummaryrefslogtreecommitdiff
path: root/docs/releasing.md
blob: d8e005d189a3d80b3757ead676cb4df13c3787c2 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
# Release Process

## Versioning

Since version 1.0, patchwork has implemented a version of
[Semantic Versioning][ref-semver]. 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

[ref-semver]: http://semver.org/