Initial instructions on releasing with gren

This commit is contained in:
Matthew Taylor 2019-09-04 22:47:55 +01:00
parent 2b8476fc63
commit b85d51a051
2 changed files with 43 additions and 6 deletions

View file

@ -1,6 +1,6 @@
# Changelog # Changelog
## v2.4.0 (27/08/2019) ## v2.4.0 (04/09/2019)
#### Bug Fixes #### Bug Fixes

View file

@ -24,9 +24,9 @@ Visit the [theme documentation](https://learn.netlify.com/en/) to see what is go
Navigate to your themes folder in your Hugo site and use the following commands: Navigate to your themes folder in your Hugo site and use the following commands:
``` ```shell
$ cd themes cd themes/
$ git clone https://github.com/matcornic/hugo-theme-learn.git git clone https://github.com/matcornic/hugo-theme-learn.git
``` ```
Check that your Hugo version is minimum `0.25` with `hugo version`. Check that your Hugo version is minimum `0.25` with `hugo version`.
@ -39,7 +39,7 @@ Check that your Hugo version is minimum `0.25` with `hugo version`.
## Download old versions (prior to 2.0.0) ## Download old versions (prior to 2.0.0)
If you need old version for compatibility purpose, either download [theme source code from releases](https://github.com/matcornic/hugo-theme-learn/releases) or use the right git tag. For example, with `1.1.0` If you need old version for compatibility purpose, either download [theme source code from releases](https://github.com/matcornic/hugo-theme-learn/releases) or use the right git tag. For example, with `1.1.0`
- Direct download way: https://github.com/matcornic/hugo-theme-learn/archive/1.1.0.zip - Direct download way: https://github.com/matcornic/hugo-theme-learn/archive/1.1.0.zip
- Git way: - Git way:
@ -55,6 +55,43 @@ For both solutions, the documentation is available at https://github.com/matcorn
Many thanks to [@vjeantet](https://github.com/vjeantet/) for the fork [docdock](https://github.com/vjeantet/hugo-theme-docdock). The v2 of this theme is mainly based on his work ! Many thanks to [@vjeantet](https://github.com/vjeantet/) for the fork [docdock](https://github.com/vjeantet/hugo-theme-docdock). The v2 of this theme is mainly based on his work !
## License ## License
[![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2Fmatcornic%2Fhugo-theme-learn.svg?type=large)](https://app.fossa.io/projects/git%2Bgithub.com%2Fmatcornic%2Fhugo-theme-learn?ref=badge_large) [![FOSSA Status](https://app.fossa.io/api/projects/git%2Bgithub.com%2Fmatcornic%2Fhugo-theme-learn.svg?type=large)](https://app.fossa.io/projects/git%2Bgithub.com%2Fmatcornic%2Fhugo-theme-learn?ref=badge_large)
## Releasing
Somewhat work-in-progress steps to release with [gren](https://github.com/github-tools/github-release-notes)
- Check all MRs assigned to the milestone are closed or pushed back to another release
- Close the milestone
- Check merged MRs on the milestone have a tag (Bug, Enhancement, etc.)
- Tag and push the repo
```shell
git tag <tag>
git push origin <tag>
```
- Generate CHANGELOG.md with _gren_
```shell
gren changelog --override --generate --tags=all
```
- Fix the date for the current release in CHANGELOG.md
- Add the changelog to git and update the tag
```shell
git add CHANGELOG.md
git commit -m "Ship tag <tag>"
git push origin master
git tag -f <tag>
git push --force origin <tag>
```
- Generate release with _gren_
```shell
gren release -t <tag>
```