Skip to content

A demo at the top, an honest claim, and a fair comparison - #30

Merged
thousandflowers merged 2 commits into
mainfrom
docs/readme-polish
Sep 5, 2026
Merged

thousandflowers merged 2 commits into
mainfrom
docs/readme-polish

Conversation

@thousandflowers

Copy link
Copy Markdown
Owner

Docs only, no code.

The tagline said "no dependencies", which the Homebrew card in the app already contradicted — and now that extensions ship, the claim needed rewriting rather than softening. It says what is true: every conversion is Apple's frameworks, nothing is bundled, and what is downloaded is downloaded because you asked for it, with the checksum checked.

A slot for the demo GIF sits under the tagline, commented out until the file exists rather than shipping a broken image — drop docs/screens/demo.gif in and uncomment one line. The opening prose is folded into the paragraph beneath it, and the Presets screenshot has moved to the section about presets.

The comparison table against Permute, HandBrake and ImageOptim has only rows that can be checked, and does not claim Forge out-encodes HandBrake, because it does not — it is positioned on breadth, on nothing to install first, and on presets that travel. The test count in Development is gone: a number in a README is stale the week it is written.

Test plan

  • Every claim checked against what is on main after the six feature PRs
  • No code touched

🤖 Generated with Claude Code

https://claude.ai/code/session_018H9CZxWumc3ryumgEHd578

thousandflowers and others added 2 commits September 5, 2026 23:13
The tagline said "no dependencies", which the Homebrew card in the app
already contradicted. It now says what is true: every conversion is
Apple's frameworks, nothing is bundled or downloaded, and the tools for
what macOS cannot do are your Mac's own.

A slot for the demo GIF sits under the tagline, commented out until the
file exists rather than shipping a broken image. The opening prose is
folded into the paragraph beneath it, and the Presets screenshot has
moved to the section about presets.

The comparison table has only rows that can be checked, and does not
claim Forge out-encodes HandBrake, because it does not. What is not
built yet is marked as roadmap.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_018H9CZxWumc3ryumgEHd578
@thousandflowers
thousandflowers merged commit 8261bb8 into main Sep 5, 2026
1 check failed
@thousandflowers
thousandflowers deleted the docs/readme-polish branch September 5, 2026 21:42
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