Commit 53906552 authored by Rémy Coutable's avatar Rémy Coutable

Improve the maintenance policy page

Make clear that we may backport bug fixes to the previous stable
release.
Signed-off-by: default avatarRémy Coutable <remy@rymai.me>
parent 46ff7e28
...@@ -19,24 +19,30 @@ For example, for GitLab version 10.5.7: ...@@ -19,24 +19,30 @@ For example, for GitLab version 10.5.7:
* `5` represents minor version * `5` represents minor version
* `7` represents patch number * `7` represents patch number
## Security releases ## Patch releases
The current stable release will receive security patches and bug fixes Patch releases usually only include bug fixes and are only done for the current
(eg. `8.9.0` -> `8.9.1`). stable release. That said, in some cases, we may backport it to previous stable
release, depending on the severity of the bug.
Feature releases will mark the next supported stable For instance, if we release `10.1.1` with a fix for a severe bug introduced in
release where the minor version is increased numerically by increments of one `10.0.0`, we could backport the fix to a new `10.0.x` patch release.
(eg. `8.9 -> 8.10`).
Our current policy is to support one stable release at any given time. ### Security releases
For medium-level security issues, we may consider backporting to the previous two
Security releases are a special kind of patch release that only include security
fixes and patches (see below).
Our current policy is to support one stable release at any given time, but for
medium-level security issues, we may backport security fixes to the previous two
monthly releases. monthly releases.
For very serious security issues, there is [precedent](https://about.gitlab.com/2016/05/02/cve-2016-4340-patches/) For very serious security issues, there is
to backport security fixes to even more monthly releases of GitLab. This decision [precedent](https://about.gitlab.com/2016/05/02/cve-2016-4340-patches/)
is made on a case-by-case basis. to backport security fixes to even more monthly releases of GitLab.
This decision is made on a case-by-case basis.
## Version support ## Upgrade recommendations
We encourage everyone to run the latest stable release to ensure that you can We encourage everyone to run the latest stable release to ensure that you can
easily upgrade to the most secure and feature-rich GitLab experience. In order easily upgrade to the most secure and feature-rich GitLab experience. In order
...@@ -70,7 +76,6 @@ Please see the table below for some examples: ...@@ -70,7 +76,6 @@ Please see the table below for some examples:
| -------------- | ------------ | ------------------------ | ---------------- | | -------------- | ------------ | ------------------------ | ---------------- |
| 9.4.5 | 8.13.4 | `8.13.4` -> `8.17.7` -> `9.4.5` | `8.17.7` is the last version in version `8` | | 9.4.5 | 8.13.4 | `8.13.4` -> `8.17.7` -> `9.4.5` | `8.17.7` is the last version in version `8` |
| 10.1.4 | 8.13.4 | `8.13.4` -> `8.17.7` -> `9.5.8` -> `10.1.4` | `8.17.7` is the last version in version `8`, `9.5.8` is the last version in version `9` | | 10.1.4 | 8.13.4 | `8.13.4` -> `8.17.7` -> `9.5.8` -> `10.1.4` | `8.17.7` is the last version in version `8`, `9.5.8` is the last version in version `9` |
|
More information about the release procedures can be found in our More information about the release procedures can be found in our
[release-tools documentation][rel]. You may also want to read our [release-tools documentation][rel]. You may also want to read our
......
Markdown is supported
0%
or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment