Skip to content

Commit

Permalink
docs: Start on the Release Process
Browse files Browse the repository at this point in the history
We should be transparent on our release process.

Co-Authored: @karabowi
  • Loading branch information
ChristianTackeGSI committed Mar 13, 2023
1 parent 0cdd160 commit e986e81
Showing 1 changed file with 62 additions and 0 deletions.
62 changes: 62 additions & 0 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -107,3 +107,65 @@ for (auto const& listEntry : *list) { /*...*/ } // avoid
for (auto const& aVol : *volList) { /*...*/ } // acceptable
for (auto const& volume : *volumes) { /*...*/ } // ✓ prefer
```
# Creating a new Release
(This is basically for the release manager, so that we don't
forget anything.)
## Control the status
* Take a look at the
[Milestone](https://github.com/FairRootGroup/FairRoot/milestones)
for the release
Consider moving still open items to another milestone
## Create a commit
On the `v{x.y}_patches` branch with comment `Bump v{x.y.z}`:
* Double check that the version number on the `project`
line in [CMakeLists.txt](CMakeLists.txt) is correct
* Apply some final editorial changes to the
[CHANGELOG](CHANGELOG.md) for the upcoming release
* Remove the `(UNRELEASED)` tag on the header
* Add the correct date
* Go over the list and re-order things/etc (classical
editorial changes)
* Apply editorial changes to [README](README.md)
* (Soon)
* Check that `codemeta.json` and friends have been
updated.
* Get a zenodo entry ready
## Push the patch to the repository:
```
git push origin v{x.y}_patches
```
## Create, control and push the new tag to the repository:
```
git tag v{x.y.z} -a -s
git show v{x.y.z}
git push origin v{x.y.z}
```
## Create a new realese on GitHub.
## In certain cases the tag should be merged onto master:
```
git checkout master
git merge origin/v{x.y}_patches
git push mainrepo origin
```
The message, when prompted, should be `Merge v{x.y.z}`.
The merge and push should not be forced.

0 comments on commit e986e81

Please sign in to comment.