Update release instructions

Signed-off-by: José Valim <[email protected]>

Author: José Valim

Makefile

@@ -146,8 +146,8 @@ release_zip: compile
 
 release_docs: docs
 	cd ../docs
-	rm -rf ../docs/master
-	mv docs ../docs/master
+	rm -rf ../docs/stable
+	mv docs ../docs/stable
 
 #==> Tests tasks
 

RELEASE.md

@@ -1,28 +1,40 @@
 # Release process
 
+## All releases
+
 This document simply outlines the release process:
 
-1. Remove all `-dev` extension from versions (see below for all files)
+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. Commit changes above with title "Release vVERSION" and generate new tag
+
+5. Run `make clean test` to ensure all tests pass from scratch and the CI is green
+
+6. Ensure minimum supported Hex works with new release (instructions upcoming)
 
-2. Ensure CHANGELOG is updated and add current date
+7. Push master and the new tag
 
-3. Commit changes above with title "Release vVERSION" and generate new tag
+8. Release new docs with `make release_docs`, move docs to `docs/stable` and push them
 
-4. Run `make clean test` to ensure all tests pass from scratch and the CI is green
+9. Release new zip with `make release_zip`, push `Precompiled.zip` to GitHub Releases
 
-5. Push master and the new tag
+10. Add the release to `elixir.csv` file in `elixir-lang/elixir-lang.github.com`
 
-6. Release new docs with `make release_docs`, move docs to `docs/stable`
+## New vMAJOR.MINOR releases
 
-7. Release new zip with `make release_zip`, push new zip to GitHub Releases, name it `Precompiled.zip`
+11. Create a new branch "vMAJOR.MINOR" release
 
-8. Fast-forward merge master into stable branch with `git merge master --ff` and push it
+12. Move stable docs to `docs/vOLD-MAJOR.OLD-MINOR`
 
-9. After release, bump versions, add `-dev` back and commit
+13. Move master docs to `docs/stable`
 
-10. `make release_docs` once again and push it to `elixir-lang/docs`
+14. Bump versions, start new CHANGELOG, add `-dev` back and commit "Start vVERSION+1"
 
-11. Add the release to `elixir.csv` file in `elixir-lang/elixir-lang.github.com`
+15. `make release_docs` and push it to `elixir-lang/docs`
 
 ## Places where version is mentioned