Skip to content

Docs cleanup: refocus SHIPPING on release ops, sync multi-account elsewhere#1

Merged
kmatzen merged 1 commit intomainfrom
docs-cleanup
Apr 26, 2026
Merged

Docs cleanup: refocus SHIPPING on release ops, sync multi-account elsewhere#1
kmatzen merged 1 commit intomainfrom
docs-cleanup

Conversation

@kmatzen
Copy link
Copy Markdown
Owner

@kmatzen kmatzen commented Apr 26, 2026

Summary

  • SHIPPING.md: rewrote as release ops (cut a release, required secrets, retry a tag, manual fallback, one-paragraph "why not the App Store"). 135 lines → 69.
  • README.md: mention multi-account in "What's in the box", drop the manual make notarize / make dmg / make sparkle-sign recipe in favor of the automated tag-push flow, update the project-layout entries.
  • PRIVACY.md + docs/privacy.html: list the new `accounts.json` state file, note that source state is per-(account, source), and that OAuth tokens are namespaced per account in the Keychain. Bump last-updated date.

Test plan

  • Skim each file; verify nothing inaccurate.
  • Render docs/privacy.html in a browser to confirm the markup still parses (just two text edits, no structural change).

…ewhere

SHIPPING.md was a pre-launch checklist (enroll in dev program, get a
Developer ID, generate Sparkle keys, decide about App Store, ...) — all
done now. Rewrote it as release ops: how to cut a release, the six
required repo secrets, how to retry a tag, the manual fallback if CI
breaks, and a one-paragraph note on why we don't ship to the App Store.
~135 lines → ~69.

README.md: mention multi-account in "What's in the box", drop the
manual `make notarize / make dmg / make sparkle-sign` recipe (the
automated workflow is the canonical path now; SHIPPING.md still has it
as a fallback), update the project-layout entry for SHIPPING.md, and
add the .github/workflows/ row.

PRIVACY.md + docs/privacy.html: list the new accounts.json state file,
clarify that source state is now per-(account, source), and that
OAuth tokens are namespaced per account in the Keychain. Bump the
last-updated date.

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@kmatzen kmatzen merged commit 006b7b0 into main Apr 26, 2026
1 check passed
@kmatzen kmatzen deleted the docs-cleanup branch April 26, 2026 14:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant