[kvlonge]

Why

The README had drifted from the site and carried a full command, configuration and custom Rule reference. Its relative image paths broke on PyPI, where the README is the package description.

Changes

• SQLBuild's README layout, opening on speed: "The fastest SQL linter.", then "50× faster than sqruff. Lint 10,000 SQL files in under a second." with a Benchmarks link next to it.
• Concise copy, a Website · Get started · Docs · Benchmarks row, the install line and the existing check/fix demo.
• A compact speed table using the figures on the published benchmarks page (10,282 Snowflake files, 4 CPUs, no cache). The caveats stay on that page, which the README links.
• Correctness and safety benefits, a short custom Python Rule taken from the docs, quick start, integrations and docs links. The reference material moved to the docs.
• Absolute image and link URLs, so the logo and demo also render on PyPI. No em dashes.

Verification

• A fresh benchmark rerun on the same corpus reproduces the claim: sqlclean check 0.81 s (median of 3; every round under 1 s) against 39.97 s for sqruff (49×; the published figure is 51×).
• Every link and image returns 200, and readme_renderer passes. A browser render shows the logo, headline, links and demo.
• The public-repository hygiene check is clean.

[cloudflare-workers-and-pages]

Deploying sqlclean with    Cloudflare Pages

Latest commit:	8e2f216
Status:	✅  Deploy successful!
Preview URL:	https://28a04db9.sqlclean.pages.dev
Branch Preview URL:	https://docs-readme-sqlbuild-layout.sqlclean.pages.dev

View logs