@@ -5,31 +5,32 @@ describes the basic standards for opening pull requests:
55
66## Branches
77
8− * The master branch of Elm is for tagging previous releases
9− and non-breaking changes, like bug fixes. This branch is
10− handy for folks who want to build the most recent public
11− release from source.
8+ * [The master branch](https://github.com/elm-lang/Elm/tree/master) is the
9+ home of the next release of the compiler so new features and improvements
10+ get merged there. Most pull requests should target this branch!
1211
13− * The dev branch is where the most active development occurs.
14− It is the home of the next release of the compiler so new
15− features and improvements get merged there.
12+ * [The stable branch](https://github.com/elm-lang/Elm/tree/stable) is for
13+ tagging previous releases and critical bug fixes. This branch is handy for
14+ folks who want to build the most recent public release from source.
15+
16+If you are working on a fairly large feature, we will probably want to merge it
17+in as its own branch and do some testing before bringing it into the master
18+branch. This way we can keep releases of the master branch independent of new
19+features.
1620
1721## Opening a pull request
1822
19−**Please open PRs against the [dev branch of
20−Elm](http://github.com/evancz/elm/tree/dev) whenever possible.** Changes that
21−are compatible with the API of master will be merged to master as soon as
22−possible. Changes that affect Elm's API will be merged to master with a future
23−release of the compiler.
23+**Please open PRs against the [master branch of
24+Elm](http://github.com/elm-lang/elm/tree/master) whenever possible.**
2425
25−Note that changes in the master branch of [Elm](https://github.com/evancz/Elm/)
26+Note that changes in the master branch of [Elm](https://github.com/elm-lang/Elm/)
2627are able to be compiled against the master branch of the [elm-lang.org
27−repo](https://github.com/evancz/elm-lang.org), and the dev branch of
28−[Elm](https://github.com/evancz/Elm/) is able to be built with the dev branch of
29−the [elm-lang.org repo](https://github.com/evancz/elm-lang.org). Please make
30−sure that your changes maintain this compatibility.
28+repo](https://github.com/elm-lang/elm-lang.org), and the stable branch of
29+[Elm](https://github.com/elm-lang/Elm/) is able to be built with the stable
30+branch of the [elm-lang.org repo](https://github.com/elm-lang/elm-lang.org).
31+Please make sure that your changes maintain this compatibility.
3132
3233## Licensing
3334
34−You should sign the [contributor agreement](ContributorAgreement.pdf)
35−and send it to <info@elm-lang.org> before opening your pull request.
35+You need to sign the [contributor agreement](ContributorAgreement.pdf)
36+and send it to <info@elm-lang.org> before opening your pull request.