Skip to content

docs: rebuild README for conversion + refresh all translations (v0.6.2)#28

Merged
youcefzemmar merged 1 commit into
veltiq:mainfrom
youcefzemmar:docs/readme-slim-0.6.2
May 31, 2026
Merged

docs: rebuild README for conversion + refresh all translations (v0.6.2)#28
youcefzemmar merged 1 commit into
veltiq:mainfrom
youcefzemmar:docs/readme-slim-0.6.2

Conversation

@youcefzemmar
Copy link
Copy Markdown
Collaborator

Tightens every README to high-conversion form using the patterns of top OSS projects (uv, Bun, Zod, Hono).

English README: 380 → 248 lines

  • Tight hero — tagline + badge row including a live monthly npm-downloads badge (npm/dm, the honest scoped-package choice; npm/dt silently downgrades to 18-month for scopes).
  • Before/after catch screenshots up top — the highest-conversion asset.
  • Two-stage value prop — verify the claims → make the agent prove it works.
  • One-command install above the fold (npx @veltiq/groundtruth setup).
  • Everything optional (CLI flags, CI, config, other agents, library API, limitations) folded into <details> or linked to /docs.

All 8 translations regenerated

zh-CN, es, pt-BR, fr, de, ja, ru, ar — matched to the new structure, correct relative paths + language switchers, Arabic wrapped RTL. Verified: downloads badge + setup present in all 8, commands untranslated, all link targets resolve.

Docs/metadata only — no behavior change. 141 tests pass, lint + typecheck clean. Ships as 0.6.2 so the slim README reaches the npm page.

🤖 Generated with Claude Code

Cut the README from 380 → ~248 lines using the patterns of top OSS projects
(uv, Bun, Zod, Hono): a tight hero (tagline + badges, incl. a live monthly
npm-downloads badge), the before/after catch screenshots up top, the two-stage
value prop (verify claims → make the agent prove it), one-command install, and
everything optional folded into <details> or linked to /docs.

Regenerated all 8 translations (zh-CN, es, pt-BR, fr, de, ja, ru, ar) to match,
with corrected relative paths and language switchers; Arabic wrapped RTL.
Docs/metadata only — no behavior change. 141 tests pass.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@youcefzemmar youcefzemmar merged commit 5ce717a into veltiq:main May 31, 2026
3 of 4 checks passed
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