From 02e0882b60cde69c137200678ac706a63dd08132 Mon Sep 17 00:00:00 2001 From: Alessandro Ghedini Date: Tue, 24 Jun 2014 13:36:15 +0200 Subject: DOCS: add document describing the release policy and procedure --- DOCS/release-policy.md | 57 ++++++++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 57 insertions(+) create mode 100644 DOCS/release-policy.md (limited to 'DOCS') diff --git a/DOCS/release-policy.md b/DOCS/release-policy.md new file mode 100644 index 0000000000..ea437ddd2c --- /dev/null +++ b/DOCS/release-policy.md @@ -0,0 +1,57 @@ +Release Policy +============== + +Every few months, a new release is cut off of the master branch and is assigned +a 0.X.0 version number. + +As part of the maintenance process, minor releases are made, which are assigned +0.X.Y version numbers. Minor releases contain bug fixes only. They never merge +the master branch, and no features are added to it. Only the latest release is +maintained. + +The goal of releases is to provide stability and an unchanged base for the sake +of Linux distributions. If you want the newest features, just use the master +branch, which is stable most of the time, except sometimes, when it's not. + +Releases other than the latest release are unsupported and unmaintained. + +Release procedure +----------------- + +- Create branch release/0.X or cherry-pick commits to the relevant branch. + +- Create and/or update the ``RELEASE_NOTES`` file. + +- Create and/or update the ``VERSION`` file. + +- Create tag v0.X.Y. + +- Push branch and tag to GitHub. + +- Create a new GitHub release using the content of ``RELEASE_NOTES``. + +Release notes template +---------------------- + +Here is a template that can be used for writing the ``RELEASE_NOTES`` file. + +```markdown +Changes +------- + +- List of changes. + +Bug fixes +--------- + +- List of bug fixes. + +New features +------------ + +- List of new features. + +This listing is not complete. There are many more bug fixes and changes. The +complete change log can be viewed by running ``git log ..`` in +the git repository. +``` -- cgit v1.2.3