Commit 76842ddbd20ea74f677c96101686f3ee31913b90
Exists in
master
and in
4 other branches
Merge pull request #3866 from senny/maintenance_guidelines
maintenance policy
Showing
3 changed files
with
27 additions
and
0 deletions
Show diff stats
CONTRIBUTING.md
| @@ -19,6 +19,7 @@ Please send a pull request with a tested solution or a pull request with a faili | @@ -19,6 +19,7 @@ Please send a pull request with a tested solution or a pull request with a faili | ||
| 19 | 19 | ||
| 20 | **Search** for similar entries before submitting your own, there's a good chance somebody else had the same issue or idea. Show your support with `:+1:` and/or join the discussion. | 20 | **Search** for similar entries before submitting your own, there's a good chance somebody else had the same issue or idea. Show your support with `:+1:` and/or join the discussion. |
| 21 | 21 | ||
| 22 | +* Only report issues for supported versions according to the [maintenance policy](MAINTENANCE.md) | ||
| 22 | * Summarize your issue in one sentence (what goes wrong, what did you expect to happen) | 23 | * Summarize your issue in one sentence (what goes wrong, what did you expect to happen) |
| 23 | * Describe your issue in detail | 24 | * Describe your issue in detail |
| 24 | * How can we reproduce the issue on the [GitLab Vagrant virtual machine](https://github.com/gitlabhq/gitlab-vagrant-vm) (start with: `vagrant destroy && vagrant up && vagrant ssh`) | 25 | * How can we reproduce the issue on the [GitLab Vagrant virtual machine](https://github.com/gitlabhq/gitlab-vagrant-vm) (start with: `vagrant destroy && vagrant up && vagrant ssh`) |
| @@ -0,0 +1,24 @@ | @@ -0,0 +1,24 @@ | ||
| 1 | +# GitLab Maintenance Policy | ||
| 2 | + | ||
| 3 | +GitLab is a fast moving and evolving project. We currently don't have the | ||
| 4 | +resources to support many releases concurrently. We support exactly one stable | ||
| 5 | +release at any given time. | ||
| 6 | + | ||
| 7 | +GitLab follows the [Semantic Versioning](http://semver.org/) for its releases: | ||
| 8 | +`(Major).(Minor).(Patch)`. | ||
| 9 | + | ||
| 10 | +* **Major version**: Whenever there is something significant or any backwards | ||
| 11 | + incompatible changes are introduced to the public API. | ||
| 12 | +* **Minor version**: When new, backwards compatible functionality is introduced | ||
| 13 | + to the public API or a minor feature is introduced, or when a set of smaller | ||
| 14 | + features is rolled out. | ||
| 15 | +* **Patch number**: When backwards compatible bug fixes are introduced that fix | ||
| 16 | + incorrect behavior. | ||
| 17 | + | ||
| 18 | +The current stable release will receive security patches and bug fixes | ||
| 19 | +(eg. `5.0` -> `5.0.1`). Feature releases will mark the next supported stable | ||
| 20 | +release where the minor version is increased numerically by increments of one | ||
| 21 | +(eg. `5.0 -> 5.1`). | ||
| 22 | + | ||
| 23 | +We encourage everyone to run this release and are trying to keep the update | ||
| 24 | +procedures simple and reliable. |
README.md
| @@ -47,6 +47,8 @@ | @@ -47,6 +47,8 @@ | ||
| 47 | 47 | ||
| 48 | ### Installation | 48 | ### Installation |
| 49 | 49 | ||
| 50 | +Check out our [maintenance policy](MAINTENANCE.md) to see what versions are supported. | ||
| 51 | + | ||
| 50 | #### Official production installation | 52 | #### Official production installation |
| 51 | 53 | ||
| 52 | * [Installation guide for a production server](https://github.com/gitlabhq/gitlabhq/blob/master/doc/install/installation.md) | 54 | * [Installation guide for a production server](https://github.com/gitlabhq/gitlabhq/blob/master/doc/install/installation.md) |