summaryrefslogtreecommitdiffstats
path: root/docs/releases/index.rst
blob: 3bb133289899e3cfba0b09d3cff6a61881e5e5f3 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
Releases
========

Versions
--------

.. toctree::
   :maxdepth: 1

   0.5
   0.4
   0.3


Versioning Policy
-----------------

Takahē approximately follows Semantic Versioning, with some specific
clarifications about what each upgrade means to you as a server administrator:

* **Patch** releases are bugfixes or small feature improvements that do not
  require a database migration. It is safe to run patch versions from the same
  minor series at the same time during an upgrade.

* **Minor** releases are larger feature improvements or other changes that
  require a database migration. Unless otherwise noted, these will be
  backwards-compatible migrations that can be applied to the database while the
  previous version is still running, before the running code is updated.

* **Major** releases may have major breaking changes that require significant
  upgrade time to perform, and will likely incur downtime. The exception will
  be our 1.0 release, which will be treated as a minor release, continuing
  on from the 0.x release series.

All release and upgrade notes can be found here, in the documentation.