;doc: RELEASING: clear checklist
This commit is contained in:
Simon Michael
parent
38a2d2e153
commit
02ffc5ab75
114
doc/RELEASING.md
114
doc/RELEASING.md
@ -10,7 +10,7 @@ Notes for hledger release managers and maintainers.
|
|||||||
## Goals
|
## Goals
|
||||||
|
|
||||||
**2024**
|
**2024**
|
||||||
- [ ] Make releasing easier
|
- [x] Make releasing easier
|
||||||
|
|
||||||
**2023**
|
**2023**
|
||||||
- [x] Make releasing eas<s>y</s>ier
|
- [x] Make releasing eas<s>y</s>ier
|
||||||
@ -173,89 +173,89 @@ Release readiness and the release process go from the bottom of this diagram to
|
|||||||
## Checklist
|
## Checklist
|
||||||
Waypoints and required artifacts.
|
Waypoints and required artifacts.
|
||||||
|
|
||||||
- [x] product
|
- [ ] product
|
||||||
- [x] blocking defects resolved
|
- [ ] blocking defects resolved
|
||||||
- [x] desired improvements landed and stabilised
|
- [ ] desired improvements landed and stabilised
|
||||||
- [x] building and passing tests with current ghcs, deps, and stackage snapshots
|
- [ ] building and passing tests with current ghcs, deps, and stackage snapshots
|
||||||
- [x] building and passing tests on all platforms
|
- [ ] building and passing tests on all platforms
|
||||||
`just relbin` (or push to github `binaries[-*]` branch)
|
`just relbin` (or push to github `binaries[-*]` branch)
|
||||||
- [x] product docs and metadata
|
- [ ] product docs and metadata
|
||||||
- [x] release branch
|
- [ ] release branch
|
||||||
- [x] version strings (in **/.version, */.version.m4, */package.yaml)
|
- [ ] version strings (in **/.version, */.version.m4, */package.yaml)
|
||||||
- [x] cabal files x 4 (hledger*/hledger*.cabal)
|
- [ ] cabal files x 4 (hledger*/hledger*.cabal)
|
||||||
`just relbranch`
|
`just relbranch`
|
||||||
- [x] options help texts up to date (in CliOptions.hs, UIOptions.hs, WebOptions.hs)
|
- [ ] options help texts up to date (in CliOptions.hs, UIOptions.hs, WebOptions.hs)
|
||||||
- [x] embedded manuals x 3
|
- [ ] embedded manuals x 3
|
||||||
- [x] generaloptions macro (in doc/common.m4)
|
- [ ] generaloptions macro (in doc/common.m4)
|
||||||
- [x] tool specific options in manuals (hledger*/hledger*.m4.md > # Options)
|
- [ ] tool specific options in manuals (hledger*/hledger*.m4.md > # Options)
|
||||||
- [x] man page dates (*/.date.m4)
|
- [ ] man page dates (*/.date.m4)
|
||||||
- [x] man (hledger*/hledger*.1)
|
- [ ] man (hledger*/hledger*.1)
|
||||||
- [x] info (hledger*/hledger*.info)
|
- [ ] info (hledger*/hledger*.info)
|
||||||
- [x] text (hledger*/hledger*.txt)
|
- [ ] text (hledger*/hledger*.txt)
|
||||||
`./Shake manuals -c`
|
`./Shake manuals -c`
|
||||||
- [x] embedded tldr pages synced with upstream (doc/tldr/*)
|
- [ ] embedded tldr pages synced with upstream (doc/tldr/*)
|
||||||
`just tldr-diff`
|
`just tldr-diff`
|
||||||
- [x] embedded asciinema demos (hledger/embeddedfiles/*.cast)
|
- [ ] embedded asciinema demos (hledger/embeddedfiles/*.cast)
|
||||||
- [x] shell completions (hledger/shell-completion/hledger-completion.bash)
|
- [ ] shell completions (hledger/shell-completion/hledger-completion.bash)
|
||||||
`just completions`, commit any changes
|
`just completions`, commit any changes
|
||||||
- [x] changelogs x 5 (**/CHANGES.md)
|
- [ ] changelogs x 5 (**/CHANGES.md)
|
||||||
`just changelogs [-c]`
|
`just changelogs [-c]`
|
||||||
`just changelogs-finalise`
|
`just changelogs-finalise`
|
||||||
- [x] release docs and artifacts
|
- [ ] release docs and artifacts
|
||||||
- [x] draft binaries building started
|
- [ ] draft binaries building started
|
||||||
`just relbin`
|
`just relbin`
|
||||||
- [x] hledger.org html manuals x 3 (site/src/VER/*.md)
|
- [ ] hledger.org html manuals x 3 (site/src/VER/*.md)
|
||||||
`just site-manuals-snapshot VER`
|
`just site-manuals-snapshot VER`
|
||||||
update `site/Makefile`, `site/js/site.js`, `site/hledger.org.caddy`
|
update `site/Makefile`, `site/js/site.js`, `site/hledger.org.caddy`
|
||||||
- [x] release notes @ hledger.org (doc/relnotes.md)
|
- [ ] release notes @ hledger.org (doc/relnotes.md)
|
||||||
`just relnotes`,
|
`just relnotes`,
|
||||||
select & transform with `md-issue-refs`,
|
select & transform with `md-issue-refs`,
|
||||||
uniquify issue refs,
|
uniquify issue refs,
|
||||||
unwrap long lines,
|
unwrap long lines,
|
||||||
add author github nicks,
|
add author github nicks,
|
||||||
commit
|
commit
|
||||||
- [x] github binary install docs up to date and pre-tested (doc/ghrelnotes.md)
|
- [ ] github binary install docs up to date and pre-tested (doc/ghrelnotes.md)
|
||||||
- [x] hledger-install up to date and pre-tested (hledger-install/hledger-install.sh)
|
- [ ] hledger-install up to date and pre-tested (hledger-install/hledger-install.sh)
|
||||||
`./Shake hledger-install-version`,
|
`./Shake hledger-install-version`,
|
||||||
check/update dep versions,
|
check/update dep versions,
|
||||||
select/test snapshot version
|
select/test snapshot version
|
||||||
- [x] hledger.org Install page up to date and pre-tested (site/src/install.md)
|
- [ ] hledger.org Install page up to date and pre-tested (site/src/install.md)
|
||||||
- [x] draft announcement for chat / mail list (doc/ANNOUNCE)
|
- [ ] draft announcement for chat / mail list (doc/ANNOUNCE)
|
||||||
- [x] draft announcement for mastodon (doc/ANNOUNCE.masto)
|
- [ ] draft announcement for mastodon (doc/ANNOUNCE.masto)
|
||||||
- [x] release tags
|
- [ ] release tags
|
||||||
`just reltags`
|
`just reltags`
|
||||||
- [x] release binaries built from tag
|
- [ ] release binaries built from tag
|
||||||
`just relbin`
|
`just relbin`
|
||||||
- [x] published
|
- [ ] published
|
||||||
- [x] all packages uploaded correctly to hackage
|
- [ ] all packages uploaded correctly to hackage
|
||||||
`just hackageupload`
|
`just hackageupload`
|
||||||
- [x] hledger-install merged to master and pushed to github
|
- [ ] hledger-install merged to master and pushed to github
|
||||||
- [x] site repo pushed to github and hledger.org, new manuals rendering correctly
|
- [ ] site repo pushed to github and hledger.org, new manuals rendering correctly
|
||||||
- [x] release branch and tags pushed to github
|
- [ ] release branch and tags pushed to github
|
||||||
`just reltags-push`
|
`just reltags-push`
|
||||||
- [x] github release with release binaries attached (https://github.com/simonmichael/hledger/releases/new)
|
- [ ] github release with release binaries attached (https://github.com/simonmichael/hledger/releases/new)
|
||||||
should be autocreated by the above; if not, https://github.com/simonmichael/hledger/releases/new,
|
should be autocreated by the above; if not, https://github.com/simonmichael/hledger/releases/new,
|
||||||
`just ghrelnotes`, paste, download release binaries, upload release binaries, review
|
`just ghrelnotes`, paste, download release binaries, upload release binaries, review
|
||||||
publish
|
publish
|
||||||
- [x] install instructions tested and working
|
- [ ] install instructions tested and working
|
||||||
- [x] hledger-install
|
- [ ] hledger-install
|
||||||
- [x] stack
|
- [ ] stack
|
||||||
- [x] cabal
|
- [ ] cabal
|
||||||
- [x] source checkout
|
- [ ] source checkout
|
||||||
- [x] github release > How to install, each platform
|
- [ ] github release > How to install, each platform
|
||||||
- [x] announced
|
- [ ] announced
|
||||||
- [x] mail list(s) hledger@googlegroups.com, + haskell-cafe@googlegroups.com for major
|
- [ ] mail list(s) hledger@googlegroups.com, + haskell-cafe@googlegroups.com for major
|
||||||
- [x] matrix
|
- [ ] matrix
|
||||||
- [x] irc
|
- [ ] irc
|
||||||
- [x] pta forum
|
- [ ] pta forum
|
||||||
- [x] mastodon
|
- [ ] mastodon
|
||||||
- [x] cleanup and support
|
- [ ] cleanup and support
|
||||||
- [x] remaining relevant release branch work merged to master
|
- [ ] remaining relevant release branch work merged to master
|
||||||
- [x] new dev tag/versions/man dates in master
|
- [ ] new dev tag/versions/man dates in master
|
||||||
`j devtag`
|
`j devtag`
|
||||||
- [x] pta.o project stats updated
|
- [ ] pta.o project stats updated
|
||||||
- [x] process notes updated/cleaned
|
- [ ] process notes updated/cleaned
|
||||||
- [x] monitor/support/handle issues:
|
- [ ] monitor/support/handle issues:
|
||||||
[issue tracker](https://github.com/simonmichael/hledger/issues?q=is%3Aopen+is%3Aissue), matrix, irc, mail list, forum, reddit
|
[issue tracker](https://github.com/simonmichael/hledger/issues?q=is%3Aopen+is%3Aissue), matrix, irc, mail list, forum, reddit
|
||||||
|
|
||||||
After release, it's a good time for:
|
After release, it's a good time for:
|
||||||
|
|||||||
Loading…
Reference in New Issue
Block a user