|
1 | 1 | Release cycle {#release-cycle} |
2 | 2 | ============= |
3 | 3 |
|
4 | | -RIOT has a new release every three months and is named after the month it |
5 | | -was feature frozen in. E.g. `2021.01` was feature frozen in January 2021. |
6 | | -Feature freeze means the branch off point of the `<YYYY.MM>-branch` with |
7 | | -`<YYYY.MM>` being the releases name. As such, any new feature merged into the |
8 | | -`master` after that point, will be part of the next release. That branch, which |
9 | | -we will call the release branch in the following is then the stable branch of |
10 | | -RIOT. |
11 | | - |
12 | | -After feature freeze, the current release candidate in the release branch is |
13 | | -tested heavily. For more information on the release testing, have a look at our |
14 | | -[release specifications][release specs]. Bug fixes that are made during this |
15 | | -testing period are back ported from `master` to the release branch and a new |
16 | | -release candidate might be created when a certain milestone is found. If all |
17 | | -major bugs are fixed, the new RIOT release is signed off by the appointed |
18 | | -release manager, usually within 2 weeks after the feature freeze. |
19 | | -More details and instructions for release managers can be found in the |
20 | | -[managing a release guide]. |
21 | | - |
22 | | -RIOT follows a rolling release cycle, meaning, that support and bug fixes are |
23 | | -only provided for the most current release. |
24 | | - |
25 | | -Download a release {#download} |
26 | | -================== |
27 | | - |
28 | | -You can download the source code of our releases [via Github][releases] as ZIP |
29 | | -file or tarball. Alternatively, you can check them out if you already cloned |
30 | | -RIOT with Git: |
31 | | - |
32 | | -~~~~~~~~~~~~~~~~~~~~ |
33 | | -$ git pull --tags |
34 | | -$ git checkout <YYYY.MM> |
35 | | -~~~~~~~~~~~~~~~~~~~~ |
36 | | - |
37 | | -Point releases and hot fixes {#point-releases} |
38 | | -============================ |
39 | | - |
40 | | -For major bug fixes, we may provide a point release `YYYY.MM.N` which results in |
41 | | -a new ZIP file or tarball over at the [release page][releases]. However, minor |
42 | | -bug fixes are only pushed to the release branch. You can fetch that via Git |
43 | | -using |
44 | | - |
45 | | -~~~~~~~~~~~~~~~~~~~~ |
46 | | -$ git clone -b `<YYYY.MM>-branch` https://github.com/RIOT-OS/RIOT |
47 | | -~~~~~~~~~~~~~~~~~~~~ |
48 | | - |
49 | | -or |
50 | | - |
51 | | -~~~~~~~~~~~~~~~~~~~~ |
52 | | -$ git pull origin <YYYY.MM-branch>:<YYYY.MM-branch> |
53 | | -$ git checkout <YYYY.MM-branch> |
54 | | -~~~~~~~~~~~~~~~~~~~~ |
55 | | - |
56 | | -if you have RIOT already cloned. |
57 | | - |
58 | | -[releases]: https://github.com/RIOT-OS/RIOT/releases |
59 | | -[release specs]: https://github.com/RIOT-OS/Release-Specs |
60 | | -[managing a release guide]: https://github.com/RIOT-OS/RIOT/tree/master/doc/guides/managing-a-release |
| 4 | +@deprecated Guides have moved to the [Guide Site](https://guide.riot-os.org/misc/release_cycle/). |
| 5 | +This page will be removed after release 2026.04. |
0 commit comments