Skip to content

Commit

Permalink
Implement consistent formatting #11
Browse files Browse the repository at this point in the history
  • Loading branch information
Ludee committed Aug 18, 2022
1 parent 54a7814 commit 6779b68
Showing 1 changed file with 19 additions and 19 deletions.
38 changes: 19 additions & 19 deletions RELEASE_PROCEDURE.md
Original file line number Diff line number Diff line change
Expand Up @@ -31,7 +31,7 @@ It always has the format `YYYY-MM-DD`, e.g. `2022-05-16`.

### 2. 🐙 Create a `GitHub Issue`
* Named `Release Patch 0.5.1`
* Use `ISSUE_TEMPLATE_RELEASE` (❗ToDo❗)
* Use `📝ISSUE_TEMPLATE_RELEASE` (❗ToDo❗)
* Discuss a good and suitable name of the release

▶️ This documents the status of the release!
Expand All @@ -40,36 +40,36 @@ It always has the format `YYYY-MM-DD`, e.g. `2022-05-16`.
* Some days before the release, inform all developers
* Merge the open pull requests
* On release day, start the release early to ensure sufficient time for reviews
* Merge everything on the *develop* branch
* Merge everything on the `develop` branch

### 4. 💠 Create a *release* branch
* Checkout *develop* and branch with `git checkout -b release-v0.5.1`
### 4. 💠 Create a `release` branch
* Checkout `develop` and branch with `git checkout -b release-v0.5.1`
* Push branch with `git push --set-upstream origin release-v0.5.1`

### 5. 📝 Update the version files
* 📝**CHANGELOG.md**
* `📝CHANGELOG.md`
* All Pull Request are included
* Add a new section with correct version number
* Give the suitable name to the release
* 📝**CITATION.cff**
* `📝CITATION.cff`
* Update the version number
* 📝**setup.py**
* Update *version*
* Update *download_url* (.../v0.5.1.tar.gz)
* **CI**
* Update *download_url* (❗ToDo❗)
* `📝setup.py`
* Update `version`
* Update `download_url` (.../v0.5.1.tar.gz)
* `📝CI` (❗ToDo❗)
* Update `download_url`

### 6. 🐙 Create a `Release Pull Request`
* Use `PR_TEMPLATE_RELEASE` (❗ToDo❗)
* Merge *release* into *production* branch
* Use `📝PR_TEMPLATE_RELEASE` (❗ToDo❗)
* Merge `release` into `production` branch
* Assign two reviewers to check the release
* Run all test
* Execute the software locally
* Wait for reviews and tests
* Merge PR but do not delete *release* branch
* Merge PR but do not delete `release` branch

### 7. 💠 Set the `Git Tag`
* Checkout *production* branch and pull
* Checkout `production` branch and pull
* Check existing tags `git tag -n`
* Create new tag: `git tag -a v0.5.1 -m "super-repo Patch Release v0.5.1 with PyPi"`
* This commit will be the final version for the release, breath three times and check again
Expand All @@ -81,7 +81,7 @@ It always has the format `YYYY-MM-DD`, e.g. `2022-05-16`.
### 8. 💻 Create and publish package on PyPi
* Navigate to git folder `cd D:\git\github\GROUP\REPO\`
* Create package using `python setup.py sdist`
* Check that file has been created in folder *dist*
* Check that file has been created in folder `dist`
* Activate python environment `activate release_py38`
* Upload to PyPi using `twine upload dist/NAME_0.5.1.tar.gz`
* Enter *name* and *password*
Expand All @@ -95,7 +95,7 @@ It always has the format `YYYY-MM-DD`, e.g. `2022-05-16`.
* Choose the correct git *tag*
* Enter the version number as title
* Summarize key changes in the description
* Add a link to the 📝**CHANGELOG.md** section
* Add a link to the `📝CHANGELOG.md` section
* `A comprehensive list of additions, changes and deletions can be found at [**CHANGELOG.md**](https://github.com/GROUP/REPO/blob/production/CHANGELOG.md)`
* Add a link to compare versions
* `**Compare versions:** [v0.5.0 - v0.5.1](https://github.com/OpenEnergyPlatform/open-MaStR/compare/v0.5.0...v0.5.1)`
Expand All @@ -105,8 +105,8 @@ It always has the format `YYYY-MM-DD`, e.g. `2022-05-16`.
* ❓ Move this section before the PyPi upload? (❗ToDo❗)

### 10. 🐙 Setup new release
* Create a Pull request from *production* to *develop*
* Create a new *unreleased section* in the 📝**CHANGELOG.md** 📝`CHANGELOG.md` `📝CHANGELOG.md`
* Create a Pull request from `production` to `develop`
* Create a new *unreleased section* in the `📝CHANGELOG.md`


## Documentation on Read the Docs (RTD)
Expand Down

0 comments on commit 6779b68

Please sign in to comment.