Commit 99e363de authored by Mike Lewis's avatar Mike Lewis

Merge branch 'docs/release-cadence-updates' into 'master'

Provide more information of release cadence

See merge request gitlab-org/gitlab-ce!24479
parents 66456863 5f902f1c
...@@ -3,21 +3,23 @@ ...@@ -3,21 +3,23 @@
## Versioning ## Versioning
GitLab follows the [Semantic Versioning](http://semver.org/) for its releases: GitLab follows the [Semantic Versioning](http://semver.org/) for its releases:
`(Major).(Minor).(Patch)` in a [pragmatic way]. `(Major).(Minor).(Patch)` in a [pragmatic way](https://gist.github.com/jashkenas/cbd2b088e20279ae2c8e).
- **Major version**: Whenever there is something significant or any backwards
incompatible changes are introduced to the public API.
- **Minor version**: When new, backwards compatible functionality is introduced
to the public API or a minor feature is introduced, or when a set of smaller
features is rolled out.
- **Patch number**: When backwards compatible bug fixes are introduced that fix
incorrect behavior.
For example, for GitLab version 10.5.7: For example, for GitLab version 10.5.7:
- `10` represents major version - `10` represents the major version. The major release was 10.0.0, but often referred to as 10.0.
- `5` represents minor version - `5` represents the minor version. The minor release was 10.5.0, but often referred to as 10.5.
- `7` represents patch number - `7` represents the patch number.
Any part of the version number can increment into multiple digits, for example, 13.10.11.
The following table describes the version types and their release cadence:
| Version type | Description | Cadence |
|:-------------|:----------|:-----------------------------------------------------------------------------------------------------------------------------------------------------------------|
| Major | For significant changes, or when any backward-incompatible changes are introduced to the public API. | Yearly. The next major release is GitLab 12.0 on June 22, 2019. Subsequent major releases will be scheduled for May 22 each year, by default. | |
| Minor | For when new backward-compatible functionality is introduced to the public API, a minor feature is introduced, or when a set of smaller features is rolled out. | Monthly on the 22nd. |
| Patch | For backward-compatible bug fixes that fix incorrect behavior. See [Patch releases](#patch-releases). | As needed. |
## Patch releases ## Patch releases
...@@ -68,7 +70,7 @@ We cannot guarantee that upgrading between major versions will be seamless. As p ...@@ -68,7 +70,7 @@ We cannot guarantee that upgrading between major versions will be seamless. As p
We recommend that you first upgrade to the latest available minor version within We recommend that you first upgrade to the latest available minor version within
your major version. By doing this, you can address any deprecation messages your major version. By doing this, you can address any deprecation messages
that could possibly change behaviour in the next major release. that could change behavior in the next major release.
Please see the table below for some examples: Please see the table below for some examples:
...@@ -79,9 +81,5 @@ Please see the table below for some examples: ...@@ -79,9 +81,5 @@ Please see the table below for some examples:
| 11.3.4 | 8.13.4 | `8.13.4` -> `8.17.7` -> `9.5.10` -> `10.8.7` -> `11.3.4` | `8.17.7` is the last version in version `8`, `9.5.10` is the last version in version `9`, `10.8.7` is the last version in version `10` | | 11.3.4 | 8.13.4 | `8.13.4` -> `8.17.7` -> `9.5.10` -> `10.8.7` -> `11.3.4` | `8.17.7` is the last version in version `8`, `9.5.10` is the last version in version `9`, `10.8.7` is the last version in version `10` |
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 documentation](https://gitlab.com/gitlab-org/release/docs). You may also want to read our
[Responsible Disclosure Policy][disclosure]. [Responsible Disclosure Policy](https://about.gitlab.com/security/disclosure/).
[rel]: https://gitlab.com/gitlab-org/release-tools/blob/master/doc/
[disclosure]: https://about.gitlab.com/disclosure/
[pragmatic way]: https://gist.github.com/jashkenas/cbd2b088e20279ae2c8e
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