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 2023-09-11 09:58:21 +01:00
parent 549823a783
commit e0d1f69575
1 changed files with 11 additions and 10 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

21
doc/RELEASING.md
View File

@ -245,7 +245,7 @@ With all platform CI tests green on same commit:
Sanity checks: Sanity checks:
- appropriate dates/versions in changelogs and release notes (if late in day, watch for time zone issues) - appropriate dates/versions in changelogs and release notes (if late in day, watch for time zone issues)
- hledger-install script - hledger-install script
- `rg '^HLEDGER(_\w+)?_VERSION' hledger-install/hledger-install.sh` - `rg '^(HLEDGER(_\w+)?_VERSION|PRICEHIST)' hledger-install/hledger-install.sh`
- binaries' --version output - binaries' --version output
- `cd ~/Downloads` - `cd ~/Downloads`
- `./hledger --version` - `./hledger --version`
@ -265,14 +265,14 @@ Sanity checks:
- in main repo, release branch: - in main repo, release branch:
- `git push github MA.JOR-branch` or magit `P p` - `git push github MA.JOR-branch` or magit `P p`
- `git push --tags` or magit `P t github` - `git push --tags` or magit `P t github`
- create new release, https://github.com/simonmichael/hledger/releases/new - create new release, <https://github.com/simonmichael/hledger/releases/new>
- choose release tag - choose release tag
- title: VERSION - title: VERSION
- description: - description:
- copy doc/github-release-doc.tmpl.md to editor - copy doc/github-release-doc.tmpl.md to emacs
- insert latest release notes (minus topmost heading) from site/src/release-notes.md - insert latest release notes (minus topmost heading) from site/src/release-notes.md
- replace A-BB, A.BB versions - replace all OLD version strings with NEW
- copy & paste - copy to github release
- preview, sanity check - preview, sanity check
- upload platform binary zip files - upload platform binary zip files
- Save draft - Save draft
@ -288,7 +288,7 @@ in main repo, release branch:
In site repo: In site repo:
- js/site.js: add NEW, 3 places - js/site.js: add NEW, 3 places
- Makefile: add NEW, 2 places - Makefile: add NEW, 3 places
- commit: `manuals: NEW` - commit: `manuals: NEW`
- make snapshot-NEW (after ensuring main repo has been release-tagged) - make snapshot-NEW (after ensuring main repo has been release-tagged)
- push - push
@ -315,12 +315,13 @@ In site repo:
- commit: `install: NEW` - commit: `install: NEW`
#### Update website #### Update website
- push to github: in site repo, `git push github` or magit `P u` - push to github: in site repo, `git push github` or magit `P p`
- on hledger.org server: - wait a few seconds for hledger.org repo to update automatically. Or if needed:
- in main repo (both main and site repos on master): - on hledger.org, with both main and site repos on master branch:
- `git -C site pull && git pull && make site` - `git -C site pull && git pull && make site`
- (or to rebuild all pages, also run `make -C site all`) - (or to rebuild all pages, also run `make -C site all`)
- in /opt/hledger/site/hledger.org.caddy: - in /ssh:simon@hledger.org:/opt/hledger/site/hledger.org.caddy (hangs ?), or
hledgerorg emacs, open /opt/hledger/site/hledger.org.caddy:
- @oldmanpath: add `path` for NEW - @oldmanpath: add `path` for NEW
- @unversionedmanpath: update to NEW - @unversionedmanpath: update to NEW
- `systemctl reload caddy` - `systemctl reload caddy`