Skip to content

README: quick-links, sharper hero, comparison table (marketing review) - #6

Merged
anshal21 merged 2 commits into
mainfrom
polish
Jul 10, 2026
Merged

README: quick-links, sharper hero, comparison table (marketing review)#6
anshal21 merged 2 commits into
mainfrom
polish

Conversation

@anshal21

Copy link
Copy Markdown
Contributor

Applies the head-of-marketing critique: quick-links row under the banner (evo/drizzle/posthog pattern) with Why whittle? as a nav link to the write-time argument, hero leads with the fidelity promise, Highlights 7→5, fail-open deduped to two load-bearing mentions, a differentiating-axes comparison table in Why write-time, who-this-is-for line, honest star ask, explicit roadmap, real banner alt text. Dev version baseline bumped to 0.3.0 for the release.

🤖 Generated with Claude Code

anshal21 and others added 2 commits July 10, 2026 09:56
…eting review)

Head-of-marketing critique of the README, all actionable items applied:
- Quick-links row under the banner (evo/drizzle/posthog pattern), including
  "Why whittle?" as a nav link to docs/why-write-time.md — the posthog form of
  a Why section, surfacing the argument without top-of-page marketing prose.
- Hero leads with the fidelity promise; routing demoted to the optional clause
  (one crisp promise for the 3-second read; routing is the second surface).
- Highlights 7 -> 5 (fail-open+local merged, executable-claims folded into the
  motif line); fail-open deduped from 5 mentions to 2 load-bearing ones.
- Comparison table in "Why write-time?" — the differentiating axes vs read-time
  proxies, evidence-shaped instead of adjective-shaped.
- Who-this-is-for line, honest star ask, explicit near-term roadmap, real alt
  text on the banner.
- Dev version baseline bumped to 0.3.0 ahead of the tagged release that ships
  the router (the release itself resolves the README-vs-@latest gap the review
  flagged as P0).

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
Verified post-release: `go install ...@latest` correctly fetched v0.3.0, but
the binary printed the baseline var (plain go install runs no ldflags). Prefer
the module version from runtime/debug.ReadBuildInfo when goreleaser didn't
inject one, so @latest users see the tag they actually installed.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@anshal21
anshal21 merged commit aedb50d into main Jul 10, 2026
1 check passed
@anshal21
anshal21 deleted the polish branch July 10, 2026 04:32
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