slaesvuo/hledger
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

;doc:RELEASING: updates

Browse Source
This commit is contained in:
Simon Michael 2025-09-16 10:49:28 -07:00
parent ae2774ecfc
commit d97a10d32c
1 changed files with 19 additions and 16 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

35
doc/RELEASING.md
View File

@ -48,7 +48,7 @@ Preview/nightly releases may happen any time.
| Manuals snapshot | ✓ | | | | Manuals snapshot | ✓ | | |
| Announcements | ✓ | | | | Announcements | ✓ | | |
[Regression bounty]: http://hledger.org/regressionbounty [Regression bounty]: https://hledger.org/regressionbounty
## hledger release artifacts / value chain ## hledger release artifacts / value chain
@ -67,6 +67,9 @@ It should be improved each time it is used.
<!-- Trailing double spaces are used for line breaks --> <!-- Trailing double spaces are used for line breaks -->
- **0. general**
- when browser (Safari) refuses to show new content, use another
- **1. product** - **1. product**
- blocking defects resolved - blocking defects resolved
- desired improvements landed and stabilised - desired improvements landed and stabilised
@ -107,23 +110,23 @@ It should be improved each time it is used.
- **3. release docs and artifacts** - **3. release docs and artifacts**
- draft binaries building started - draft binaries building started
`just relbin` `just relbin`
- hledger.org html manuals x 3 (`site/src/MAJORVER/*.md`) - hledger.org html manuals x 3 (site/src/MAJORVER/\*.md) (major release only)
`just site-manuals-snapshot MAJORVER` (creates or updates) `just site-manuals-snapshot MAJORVER` to create/update
update `site/Makefile`, `site/js/site.js`, `site/hledger.org.caddy` (major release only) update `site/Makefile`, `site/js/site.js`, `site/hledger.org.caddy`
- release notes @ hledger.org (doc/relnotes.md) - release notes @ hledger.org (doc/relnotes.md)
`just relnotes` *(XXX minor release: moves previous release's summary, adds whitespace)*, `just relnotes` *(XXX minor release: moves previous release's summary, adds whitespace)*,
*(XXX may be no longer needed)* select & transform with `md-issue-refs`, uniquify select & transform with `md-issue-refs`, uniquify *(XXX no longer needed ?)*
add author github nicks, add author github nicks,
add summary, add summary,
commit commit
- github binary install docs (doc/ghrelnotes.md) up to date and pre-tested - github binary install docs (doc/ghrelnotes.md) up to date and pre-tested
- Install page (site/src/install.md) up to date and pre-tested - Install page (site/src/install.md) up to date and pre-tested
- draft announcement for chat / mail list (doc/ANNOUNCE) - draft long announcement for chat, mail list (doc/ANNOUNCE)
- draft announcement for mastodon (doc/ANNOUNCE.masto) - draft short announcement for mastodon etc (doc/ANNOUNCE.short)
- release tags - release tags
`just reltags` `just reltags`
- release binaries built from tag - release binaries built from tag
`just relbin` `just relbin`,
wait for all to succeed wait for all to succeed
- Install page (site/src/install.md) --version examples match release binaries - Install page (site/src/install.md) --version examples match release binaries
@ -134,15 +137,15 @@ It should be improved each time it is used.
announcements announcements
- nightly release changes link up to date in master (doc/ghnightlynotes.md) - nightly release changes link up to date in master (doc/ghnightlynotes.md)
- all packages uploaded correctly to hackage - all packages uploaded correctly to hackage
`just hackageupload`, check versions, confirm, check all uploads successful `just hackageupload`
- master branch pushed to github - master branch pushed to github
- new manuals published and rendering/redirecting correctly - new manuals published and rendering/redirecting correctly
- site repo pushed to github - site repo pushed to github
- main and site repos auto-pulled to hledger.org, site rebuilt - main and site repos auto-pulled to hledger.org, site rebuilt
`hledgerorgsh grep release.= /opt/hledger/site/out/js/site.js` `hledgerorgsh grep release.= /opt/hledger/site/out/js/site.js`
- https://www.hledger.org/js/site.js showing latest version - <https://www.hledger.org/js/site.js> showing latest version
`curl -s https://hledger.org/js/site.js | grep release.=` `curl -s https://hledger.org/js/site.js | grep release.=`
purge cache at https://dash.cloudflare.com/f629035917dd3b99b1e37ae20c15ff09/hledger.org/caching/configuration (major release only) purge cache at <https://dash.cloudflare.com/f629035917dd3b99b1e37ae20c15ff09/hledger.org/caching/configuration> (major release only)
- default manual urls redirecting to latest version (major release only) - default manual urls redirecting to latest version (major release only)
`hledgerorgsh sh -c 'systemctl stop caddy; systemctl start caddy'` `hledgerorgsh sh -c 'systemctl stop caddy; systemctl start caddy'`
`curl -sI https://hledger.org/hledger.html | grep location` `curl -sI https://hledger.org/hledger.html | grep location`
@ -150,10 +153,10 @@ It should be improved each time it is used.
- release tags pushed to github - release tags pushed to github
`just reltags-push VER` `just reltags-push VER`
- github draft release with release binaries attached - github draft release with release binaries attached
https://github.com/simonmichael/hledger/releases/new *(XXX safari may not show new tag, may need brave)* <https://github.com/simonmichael/hledger/releases/new> *(XXX safari may not show new tag, may need brave)*
`just ghrel-notes` `just ghrel-notes`
`just ghruns-download` (or if throttled: `just ghruns-open`, download to tmp/, unzip the unix ones) `just ghbin-download` <!-- (or if throttled: `just ghbin`, download to tmp/, unzip the unix ones) -->
`just ghrel-upload VER` `just ghrel-bin VER`
- github release published - github release published
review, review,
publish publish
@ -177,7 +180,7 @@ It should be improved each time it is used.
review, edit review, edit
propagate propagate
- new dev tag/versions/man dates in master (major version only) - new dev tag/versions/man dates in master (major version only)
`j devtagø` `j devtag`
- pta.o project stats updated - pta.o project stats updated
- process notes updated/cleaned - process notes updated/cleaned
- monitor/support/handle issues: - monitor/support/handle issues: