diff --git a/doc/RELEASING.md b/doc/RELEASING.md
index 95e62f633..5942a60e3 100644
--- a/doc/RELEASING.md
+++ b/doc/RELEASING.md
@@ -9,16 +9,19 @@ Notes for hledger release managers and maintainers.
## Goals
+**2025**
+[ ] Make releasing easier
+\
**2024**
-- [x] Make releasing easier
-
+[x] Make releasing easier
+\
**2023**
-- [x] Make releasing easyier
-
+[x] Make releasing easyier
+\
**2022**
-- [x] Update/consolidate release process docs
-- [x] Establish routine monthly release cadence
-- [ ] Make releasing easy
+[x] Update/consolidate release process docs,
+[x] Establish routine monthly release cadence,
+[ ] Make releasing easy
## Release types
@@ -183,7 +186,8 @@ Waypoints and required artifacts.
- [ ] release branch
- [ ] version strings (in **/.version, */.version.m4, */package.yaml)
- [ ] cabal files x 4 (hledger*/hledger*.cabal)
- `just relbranch`
+ `just relbranch VER`,
+ `just cabalfilestest`
- [ ] options help texts up to date (in CliOptions.hs, UIOptions.hs, WebOptions.hs)
- [ ] embedded manuals x 3
- [ ] generaloptions macro (in doc/common.m4)
@@ -214,28 +218,50 @@ Waypoints and required artifacts.
unwrap long lines,
add author github nicks,
commit
- - [ ] github binary install docs up to date and pre-tested (doc/ghrelnotes.md)
- - [ ] hledger-install up to date and pre-tested (hledger-install/hledger-install.sh)
- `./Shake hledger-install-version`,
+ - [ ] github binary install docs (doc/ghrelnotes.md) up to date and pre-tested
+ - [ ] hledger-install/hledger-install.sh up to date and pre-tested
+ (`./Shake hledger-install-version` ?),
check/update dep versions,
select/test snapshot version
- - [ ] hledger.org Install page up to date and pre-tested (site/src/install.md)
+ - [ ] Install page (site/src/install.md) up to date and pre-tested
- [ ] draft announcement for chat / mail list (doc/ANNOUNCE)
- [ ] draft announcement for mastodon (doc/ANNOUNCE.masto)
- [ ] release tags
`just reltags`
- [ ] release binaries built from tag
`just relbin`
+ - [ ] Install page (site/src/install.md) --version examples match release binaries
- [ ] published
+ - [ ] relevant release branch work cherry-picked to master branch
+ changelogs
+ relnotes
+ hledger-install
+ announcements
- [ ] all packages uploaded correctly to hackage
- `just hackageupload`
- - [ ] hledger-install merged to master and pushed to github
- - [ ] site repo pushed to github and hledger.org, new manuals rendering correctly
- - [ ] release branch and tags pushed to github
- `just reltags-push`
- - [ ] 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,
- `just ghrelnotes`, paste, download release binaries, upload release binaries, review
+ `just hackageupload`, check versions, confirm, check all uploads successful
+ - [ ] master branch pushed to github
+ - [ ] new manuals published and rendering/redirecting correctly
+ - [ ] site repo pushed to github
+ - [ ] main and site repos auto-pulled to hledger.org, site rebuilt
+ `hledgerorgsh grep release.= /opt/hledger/site/out/js/site.js`
+ - [ ] https://www.hledger.org/js/site.js showing latest version
+ `curl -s https://hledger.org/js/site.js | grep release.=`
+ purge cache at https://dash.cloudflare.com/f629035917dd3b99b1e37ae20c15ff09/hledger.org/caching/configuration
+ - [ ] default manual urls redirecting to latest version
+ `hledgerorgsh sh -c 'systemctl stop caddy; systemctl start caddy'`
+ `curl -sI https://hledger.org/hledger.html | grep location`
+ - [ ] release branch pushed to github
+ - [ ] release tags pushed to github
+ `just reltags-push VER`
+ - [ ] github draft release with release binaries attached
+ should be autocreated by the above; if not,
+ (https://github.com/simonmichael/hledger/releases/new)
+ `just ghrelnotes-push`
+ (`just ghruns-download`, too slow)
+ instead: `just ghruns-open`, download to tmp/, unzip the unix ones
+ `just ghrelease-upload`
+ - [ ] github release published
+ review,
publish
- [ ] install instructions tested and working
- [ ] hledger-install
@@ -247,13 +273,15 @@ Waypoints and required artifacts.
- [ ] mail list(s) hledger@googlegroups.com, + haskell-cafe@googlegroups.com for major
- [ ] matrix
- [ ] irc
- - [ ] pta forum
- [ ] mastodon
+ - [ ] pta forum
- [ ] cleanup and support
- - [ ] remaining relevant release branch work merged to master
+ - [ ] review/polish relnotes, changelogs
+ review, edit
+ propagate
- [ ] new dev tag/versions/man dates in master
- `j devtag`
- - [ ] pta.o project stats updated
+ `j devtag VER.99`
+ - [ ]y pta.o project stats updated
- [ ] process notes updated/cleaned
- [ ] monitor/support/handle issues:
[issue tracker](https://github.com/simonmichael/hledger/issues?q=is%3Aopen+is%3Aissue), matrix, irc, mail list, forum, reddit