summaryrefslogtreecommitdiff
path: root/RELEASE.md
blob: e3c0e0462e4d2e95d4fa74d28e1b259a3bbb8be3 (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
# Release process

## All releases

This document simply outlines the release process:

1. Ensure you are running on the oldest supported Erlang version

2. Remove all `-dev` extension from versions (see below for all files)

3. Ensure CHANGELOG is updated and add current date

4. If a new `vMAJOR.MINOR`, replace "master" with "vVERSION" in the "Deprecations" page and commit

5. If a new `vMAJOR.MINOR`, create a new branch "vMAJOR.MINOR" and set `CANONICAL=` in Makefile

6. Commit changes above with title "Release vVERSION" and generate new tag

7. Run `make clean test` to ensure all tests pass from scratch and the CI is green

8. Recompile an existing project (for example, Ecto) to ensure manifests can be upgraded

9. Push branch and the new tag

10. Publish new zips with `make zips`, upload `Precompiled.zip` and `Docs.zip` to GitHub Releases

11. Add the release to `elixir.csv` and `_data/elixir-versions.yml` files in `elixir-lang/elixir-lang.github.com`

12. After a new `vMAJOR.MINOR`, move back to master, bump versions, start new CHANGELOG, add `-dev` back and commit "Start vMAJOR.MINOR+1"

## Places where version is mentioned

* VERSION
* CHANGELOG.md
* src/elixir.app.src (not lib/elixir/src/elixir.app.src)