Skip to content

Commit b33fa73

Browse files
committed
docs: streamline release steps
1 parent ae3e994 commit b33fa73

File tree

1 file changed

+23
-10
lines changed

1 file changed

+23
-10
lines changed

RELEASING.md

Lines changed: 23 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -22,9 +22,7 @@ cat src-tauri/tauri.conf.json
2222
cat package.json
2323
```
2424

25-
Bump both to the release version before building.
26-
27-
After the release is published, bump both to the next minor.
25+
Bump both to the release version before building. After the release is published, bump both to the next minor.
2826

2927
## Build
3028

@@ -50,15 +48,21 @@ CODESIGN_IDENTITY="Developer ID Application: Your Name (TEAMID)" \
5048

5149
## Sign + Notarize + Staple (Human Step)
5250

53-
1) Zip the app:
51+
1) Confirm signing identity (from Keychain):
52+
53+
```bash
54+
security find-identity -v -p codesigning
55+
```
56+
57+
2) Zip the app:
5458

5559
```bash
5660
ditto -c -k --keepParent \
5761
src-tauri/target/release/bundle/macos/CodexMonitor.app \
5862
CodexMonitor.zip
5963
```
6064

61-
2) Store notary credentials (one-time per machine):
65+
3) Store notary credentials (one-time per machine):
6266

6367
```bash
6468
xcrun notarytool store-credentials codexmonitor-notary \
@@ -67,28 +71,27 @@ xcrun notarytool store-credentials codexmonitor-notary \
6771
--password "app-specific-password"
6872
```
6973

70-
If the profile already exists in Keychain, skip this step and reuse:
74+
If the profile already exists in Keychain, reuse it:
7175

7276
```bash
7377
--keychain-profile "codexmonitor-notary"
7478
```
7579

76-
If your `notarytool` build does not support listing profiles, validate the
77-
profile by running:
80+
Validate the profile (works even if listing is unsupported):
7881

7982
```bash
8083
xcrun notarytool history --keychain-profile "codexmonitor-notary"
8184
```
8285

83-
3) Submit for notarization and wait:
86+
4) Submit for notarization and wait:
8487

8588
```bash
8689
xcrun notarytool submit CodexMonitor.zip \
8790
--keychain-profile "codexmonitor-notary" \
8891
--wait
8992
```
9093

91-
4) Staple the app:
94+
5) Staple the app:
9295

9396
```bash
9497
xcrun stapler staple \
@@ -117,6 +120,16 @@ hdiutil create -volname "CodexMonitor" \
117120
release-artifacts/CodexMonitor_<RELEASE_VERSION>_aarch64.dmg
118121
```
119122

123+
## Generate Changelog (from git log)
124+
125+
Create release notes from the tag range using plain git log:
126+
127+
```bash
128+
git log --name-only --pretty=format:"%h %s" v<PREV_VERSION>..v<RELEASE_VERSION>
129+
```
130+
131+
Summarize user-facing changes into short bullet points and use them in the GitHub release notes.
132+
120133
## GitHub Release (with gh)
121134

122135
```bash

0 commit comments

Comments
 (0)