diff options
author | Todd Gamblin <tgamblin@llnl.gov> | 2020-07-04 01:50:55 -0700 |
---|---|---|
committer | Todd Gamblin <tgamblin@llnl.gov> | 2020-08-13 00:33:31 -0700 |
commit | 303882834ac1ace64fcad9cebf7d0ffc228d76a9 (patch) | |
tree | a0801ed28d0118b3a860512372a31f4e29dbb3ba /README.md | |
parent | 5b63ec86528d52d7bfa86bef9abdf263d2ddc9bf (diff) | |
download | spack-303882834ac1ace64fcad9cebf7d0ffc228d76a9.tar.gz spack-303882834ac1ace64fcad9cebf7d0ffc228d76a9.tar.bz2 spack-303882834ac1ace64fcad9cebf7d0ffc228d76a9.tar.xz spack-303882834ac1ace64fcad9cebf7d0ffc228d76a9.zip |
docs: document releases and branches in Spack
- [x] Remove references to `master` branch
- [x] Document how release branches are structured
- [x] Document how to make a major release
- [x] Document how to make a point release
- [x] Document how to do work in our release projects
Diffstat (limited to 'README.md')
-rw-r--r-- | README.md | 26 |
1 files changed, 21 insertions, 5 deletions
@@ -78,11 +78,27 @@ these guidelines with [Travis CI](https://travis-ci.org/spack/spack). To run these tests locally, and for helpful tips on git, see our [Contribution Guide](http://spack.readthedocs.io/en/latest/contribution_guide.html). -Spack uses a rough approximation of the -[Git Flow](http://nvie.com/posts/a-successful-git-branching-model/) -branching model. The ``develop`` branch contains the latest -contributions, and ``master`` is always tagged and points to the latest -stable release. +Spack's `develop` branch has the latest contributions. Pull requests +should target `develop`, and users who want the latest package versions, +features, etc. can use `develop`. + +Releases +-------- + +For multi-user site deployments or other use cases that need very stable +software installations, we recommend using Spack's +[stable releases](https://github.com/spack/spack/releases). + +Each Spack release series also has a corresponding branch, e.g. +`releases/v0.14` has `0.14.x` versions of Spack, and `releases/v0.13` has +`0.13.x` versions. We backport important bug fixes to these branches but +we do not advance the package versions or make other changes that would +change the way Spack concretizes dependencies within a release branch. +So, you can base your Spack deployment on a release branch and `git pull` +to get fixes, without the package churn that comes with `develop`. + +See the [docs on releases](https://spack.readthedocs.io/en/latest/developer_guide.html#releases) +for more details. Code of Conduct ------------------------ |