Skip to content

Cut the docs down to what a reader needs - #207

Merged
andiwand merged 1 commit into
mainfrom
shorter-docs
Sep 24, 2026
Merged

andiwand merged 1 commit into
mainfrom
shorter-docs

Conversation

@andiwand

@andiwand andiwand commented Sep 24, 2026 •

Copy link
Copy Markdown
Member

The README and the two fastlane notes had grown into long prose with the reasons behind each decision. This keeps the facts and the rules, in tables and numbered steps, and drops the backstories.

file before after
README.md 360 lines 199 lines
fastlane/metadata/README.md 109 lines 61 lines
fastlane/screenshots/README.md 61 lines 52 lines
CHANGELOG.md preamble 15 lines 13 lines, as a rule list

Every claim was checked against the code, the Fastfile and the release workflow. Three errors are fixed:

  • The search in the screenshots is on the PDF screen, not the text screen.
  • The release run has a screenshot-set job that joins the two device halves. It was missing from the job list.
  • The framing step, scripts/frame-screenshots.py, was never named.

🤖 Generated with Claude Code

The README and the two fastlane notes had grown into long prose with the
reasons behind each decision. This keeps the facts and the rules, in
tables and numbered steps, and drops the backstories.

Three errors are fixed along the way: the search in the screenshots is
on the PDF screen, not the text screen; the release run has a
`screenshot-set` job that joins the two device halves; and the framing
step, `scripts/frame-screenshots.py`, was never named.

Co-Authored-By: Claude Fable 5.1 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_012cUrpMSNS7LocmwZB22G2r
@andiwand
andiwand merged commit d633f90 into main Sep 24, 2026
1 check passed
@andiwand
andiwand deleted the shorter-docs branch September 24, 2026 09:28
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