| 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
...
@@ -66,9 +68,9 @@ one major version. For example, it is safe to:
...
@@ -66,9 +68,9 @@ one major version. For example, it is safe to:
Upgrading the major version requires more attention.
Upgrading the major version requires more attention.
We cannot guarantee that upgrading between major versions will be seamless. As previously mentioned, major versions are reserved for backwards incompatible changes.
We cannot guarantee that upgrading between major versions will be seamless. As previously mentioned, major versions are reserved for backwards incompatible changes.
We recommend that you first upgrade to the latest available version within your
We recommend that you first upgrade to the latest available minor version within
major version. By doing this, you can address any deprecation messages that
your major version. By doing this, you can address any deprecation messages
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