@@ -3,15 +3,15 @@ Prepare a release based on docs/guides/releasing.md.
331 . Prerequisite: Run ` gh secret list ` and verify that ` TAURI_SIGNING_PRIVATE_KEY ` and
44 ` TAURI_SIGNING_PRIVATE_KEY_PASSWORD ` both exist. If either is missing, warn the user and stop.
552 . Update @CHANGELOG .md based on git commits since last release.
6- - Commits have title + body — read all!
6+ - Commits have title + body. Read all!
77 - You can link multiple commits for changelog items if needed.
88 - List major but non-app changes in a "Non-app" section.
9- - ** Get commit SHAs via ` git log --format='%h' --abbrev=8 ` ** — never extend a 7-char prefix from ` git log --oneline `
9+ - ** Get commit SHAs via ` git log --format='%h' --abbrev=8 ` ** . Never extend a 7-char prefix from ` git log --oneline `
1010 by guessing the next character. The committed changelog convention is 8 chars; let git produce them. The
1111 ` changelog-links ` check will reject fabricated SHAs and abort the release.
1212 - ** Add a ` ## [Unreleased] ` heading** right after the format preamble (before the first versioned section), then put
1313 entries under it. The release script replaces this heading with the versioned one. The committed changelog has no
14- ` [Unreleased] ` section between releases — you 're creating it fresh each time.
14+ ` [Unreleased] ` section between releases. You 're creating it fresh each time.
1515
1616 ### Style: plain-sentence, dense, impact-focused
1717 - ** Each entry is one sentence.** No ` **Bold title:** Body. ` ; the headline IS the entry. Most entries land under 20
@@ -59,7 +59,7 @@ Prepare a release based on docs/guides/releasing.md.
5959
6060 > - Add friendly errors for git browser ([ 19d5b075] ( ... ) , [ af64689f] ( ... ) ).
6161
62- ** Keep long when warranted** (true tentpole launches like Linux alpha — many real commits, big story):
62+ ** Keep long when warranted** (true tentpole launches like Linux alpha, with many real commits and a big story):
6363
6464 > - Add Linux support (alpha): volumes via /proc/mounts, file ops with reflink support, trash via FreeDesktop spec,
6565 > inotify file watching, MTP ungated, SMB via mDNS + smbclient fallback, GVFS-mounted shares as volumes, native
@@ -76,18 +76,18 @@ Prepare a release based on docs/guides/releasing.md.
76767 . ** After pushing** , confirm the self-hosted runner picked up the build:
7777 - Wait ~ 30 seconds, then run ` gh run view <release-run-id> --json jobs ` and check the ` Build (...) ` jobs.
7878 - At least one ` Build (...) ` job should be ` in_progress ` (the self-hosted runner serializes the three matrix jobs, so
79- the others stay ` queued ` — that's normal).
79+ the others stay ` queued ` , which is normal).
8080 - ** If all three are still ` queued ` after ~ 30s, the self-hosted runner is down.** Confirm with
8181 ` launchctl list | grep cmdr ` and look for ` actions.runner.vdavid-cmdr.* ` . Restart with
8282 ` cd ~/actions-runner-cmdr && ./svc.sh start ` (fall back to ` launchctl bootout ` + ` bootstrap ` if ` svc.sh ` errors
8383 with "Load failed: 5: Input/output error"). Re-check after another 30 s. The queued jobs pick up automatically once
84- the runner reports in — no need to re-trigger or re-tag.
84+ the runner reports in. No need to re-trigger or re-tag.
85858 . ** Then arm ` caffeinate ` ** to prevent the Mac from sleeping during the build. The self-hosted runner lives on this
86- Mac; any sleep — display or system — drops the runner connection and fails every in-flight matrix job with
86+ Mac; any sleep ( display or system) drops the runner connection and fails every in-flight matrix job with
8787 ` The self-hosted runner lost communication with the server ` . See ` docs/guides/releasing.md ` § "Keep the Mac awake
8888 during the build".
8989 - Run ` caffeinate -dimsu ` as a Bash ` run_in_background ` call. Capture the background task id so you can stop it.
90- - Disarm it once the release workflow reports ` completed ` (success or failure — not just when the matrix is done).
90+ - Disarm it once the release workflow reports ` completed ` (success or failure, not just when the matrix is done).
9191 - If the user requests a re-run of failed jobs, re-arm caffeinate first.
92929 . ** Monitor the CI build** :
9393 - Remind the user not to close their laptop for ~ 15 minutes while the self-hosted runner builds.
@@ -97,14 +97,14 @@ Prepare a release based on docs/guides/releasing.md.
9797 fix.
9898 - Suggest the user to also track the build at https://github.com/vdavid/cmdr/actions .
999910 . ** In parallel, watch the standalone CI run** (the non-release ` CI ` workflow that fires on the same push):
100- - It's not a blocker for the release. If it goes red, fix it in the background while the release builds — small
100+ - It's not a blocker for the release. If it goes red, fix it in the background while the release builds. Small
101101 things like lint regressions are common.
102102 - Surface the failure to the user when convenient; don't interrupt release-build progress reporting for it.
10310311 . ** After the release run succeeds, verify the public surface** :
104- - ` gh release view vX.Y.Z --json assets,tagName,publishedAt ` — confirm the expected DMGs are attached
104+ - ` gh release view vX.Y.Z --json assets,tagName,publishedAt ` : confirm the expected DMGs are attached
105105 (` Cmdr_X.Y.Z_aarch64.dmg ` , ` _x64.dmg ` , ` _universal.dmg ` ) and sizes look reasonable.
106106 - Wait ~ 30 seconds for the website auto-deploy (the release workflow commits an updated ` latest.json ` and fires a
107107 webhook), then ` curl -s https://getcmdr.com/latest.json | jq -r .version ` and confirm it matches ` X.Y.Z ` .
108108 - If ` latest.json ` still shows the old version after ~ 2 minutes, the deploy webhook may have failed silently. Tell
109109 the user; the manual fix is to re-trigger the website-deploy workflow via ` workflow_dispatch ` from the Actions
110- tab. Don't block release success on this — the GitHub Release is what users actually download.
110+ tab. Don't block release success on this. The GitHub Release is what users actually download.
0 commit comments