summaryrefslogtreecommitdiff
diff options
context:
space:
mode:
authorDmitriy Zaporozhets <dmitriy.zaporozhets@gmail.com>2013-05-07 04:31:08 -0700
committerDmitriy Zaporozhets <dmitriy.zaporozhets@gmail.com>2013-05-07 04:31:08 -0700
commit76842ddbd20ea74f677c96101686f3ee31913b90 (patch)
tree440b05b77f985e7a698d3647ebb714959fd55184
parent961b56a613e15b0c67a3979238fe677bf5264233 (diff)
parent3dc4fc23c6b687af4dbd194070908801ec110d82 (diff)
downloadgitlab-ce-76842ddbd20ea74f677c96101686f3ee31913b90.tar.gz
Merge pull request #3866 from senny/maintenance_guidelines
maintenance policy
-rw-r--r--CONTRIBUTING.md1
-rw-r--r--MAINTENANCE.md24
-rw-r--r--README.md2
3 files changed, 27 insertions, 0 deletions
diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md
index 943d910ecf5..437434793e6 100644
--- a/CONTRIBUTING.md
+++ b/CONTRIBUTING.md
@@ -19,6 +19,7 @@ Please send a pull request with a tested solution or a pull request with a faili
**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.
+* Only report issues for supported versions according to the [maintenance policy](MAINTENANCE.md)
* Summarize your issue in one sentence (what goes wrong, what did you expect to happen)
* Describe your issue in detail
* 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`)
diff --git a/MAINTENANCE.md b/MAINTENANCE.md
new file mode 100644
index 00000000000..5168a0e8228
--- /dev/null
+++ b/MAINTENANCE.md
@@ -0,0 +1,24 @@
+# GitLab Maintenance Policy
+
+GitLab is a fast moving and evolving project. We currently don't have the
+resources to support many releases concurrently. We support exactly one stable
+release at any given time.
+
+GitLab follows the [Semantic Versioning](http://semver.org/) for its releases:
+`(Major).(Minor).(Patch)`.
+
+* **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.
+
+The current stable release will receive security patches and bug fixes
+(eg. `5.0` -> `5.0.1`). Feature releases will mark the next supported stable
+release where the minor version is increased numerically by increments of one
+(eg. `5.0 -> 5.1`).
+
+We encourage everyone to run this release and are trying to keep the update
+procedures simple and reliable.
diff --git a/README.md b/README.md
index af8b4648d51..8579cf05b89 100644
--- a/README.md
+++ b/README.md
@@ -47,6 +47,8 @@
### Installation
+Check out our [maintenance policy](MAINTENANCE.md) to see what versions are supported.
+
#### Official production installation
* [Installation guide for a production server](https://github.com/gitlabhq/gitlabhq/blob/master/doc/install/installation.md)