2.5 KiB
2.5 KiB
| name | description |
|---|---|
| whats-new | Write user-facing release notes ("What's new") for a mobile app or game update from the git log since the last tag - hook in the first line, plain user language, localized into every listing language, within store limits (Google Play 500, App Store 4000 characters). Use when preparing an update, when the user asks for release notes / changelog for the stores, or before play release / apple listing for a new version. |
What's new (release notes)
CLI: storebound whats-new [--since v1.2.0] [--dry]. It reads git log <tag>..HEAD, drops housekeeping commits
(chore, ci, docs, refactor, test, merges, version bumps), turns feat: / fix: / perf: subjects into bullets and
writes a draft into the default language of store/listing.md (Play "What's new") and store/appstore.md
(whatsNew). Nothing is sent to a store. --all writes the draft into every language as a starting point for
translation; storebound check warns while a translation is still identical to the source.
Write it for your users
- Run
storebound whats-new --dry, read the draft with the owner. - Rewrite:
- First line = hook (the stores show roughly the first 170 characters before "more"): the most exciting change in user words ("New: shared lists with your family" for an app, "New: 20 desert levels and a daily challenge!" for a game).
- Then 2-5 bullets, most visible first. User words, not code words: "Lists open faster" / "Levels load faster", not "refactor asset loader"; never internal ids, branch names or ticket numbers.
- Fixes in one line unless a fix was a known user complaint.
- No promises of future features, no prices, no other platforms.
- Translate into every listing language (natural tone, the app's own terms, same meaning; not word by word). Arabic stays RTL; keep numbers and product names as they are.
- Limits: Google Play 500 characters per language, App Store 4000;
storebound checkenforces both. A first App Store version has no "What's new" (storebound leaves it empty there). - Push:
storebound play release ...uses the Play notes;storebound apple listing --version x --build Nthe App Store ones.
Gotchas
- Squash-merged repos: the PR titles are the subjects; keep them in conventional form (
feat: ...) to get clean drafts. - Commits marked
[skip notes]or[internal]are left out. - Release notes are public: nothing about cheats, exploits, unreleased content or private names.