diff options
author | Stephen Finucane <stephen.finucane@intel.com> | 2016-02-02 23:18:16 +0000 |
---|---|---|
committer | Stephen Finucane <stephen.finucane@intel.com> | 2016-02-05 17:37:56 +0000 |
commit | 6868e36096a6aaf9198d24cdc4f8dd8cdd9f4694 (patch) | |
tree | ddeaf2ae3097d8ade8e52e23da2426b7c6ae137d | |
parent | 919d71943b718fee3fad867f3c5c20fa7c9def27 (diff) | |
download | patchwork-6868e36096a6aaf9198d24cdc4f8dd8cdd9f4694.tar patchwork-6868e36096a6aaf9198d24cdc4f8dd8cdd9f4694.tar.gz |
docs: Add a release process guide
This guide serves to illustrate import aspects of patchworks release
process: when, why and how. It also serves as a helpful reminder for
the maintainers themselves.
Signed-off-by: Stephen Finucane <stephen.finucane@intel.com>
-rw-r--r-- | docs/releasing.md | 32 | ||||
-rw-r--r-- | mkdocs.yml | 1 |
2 files changed, 33 insertions, 0 deletions
diff --git a/docs/releasing.md b/docs/releasing.md new file mode 100644 index 0000000..d8e005d --- /dev/null +++ b/docs/releasing.md @@ -0,0 +1,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/
\ No newline at end of file @@ -9,3 +9,4 @@ pages: - Installation: 'installation.md' - Development: 'development.md' - Contributing: 'contributing.md' + - Release Process: 'releasing.md' |