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 | 19 | |
| 20 | 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 | 23 | * Summarize your issue in one sentence (what goes wrong, what did you expect to happen) |
| 23 | 24 | * Describe your issue in detail |
| 24 | 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 @@ |
| 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 | 47 | |
| 48 | 48 | ### Installation |
| 49 | 49 | |
| 50 | +Check out our [maintenance policy](MAINTENANCE.md) to see what versions are supported. | |
| 51 | + | |
| 50 | 52 | #### Official production installation |
| 51 | 53 | |
| 52 | 54 | * [Installation guide for a production server](https://github.com/gitlabhq/gitlabhq/blob/master/doc/install/installation.md) | ... | ... |