Skip to content

docs: polish the README header, opening, demo and benchmark table - #10

Merged
kvlonge merged 2 commits into
mainfrom
docs/readme-polish
Oct 31, 2026
Merged

kvlonge merged 2 commits into
mainfrom
docs/readme-polish

Conversation

@kvlonge

@kvlonge kvlonge commented Oct 31, 2026

Copy link
Copy Markdown
Contributor

Why

Review of the new README found five issues: the black logo rectangle, a fragmented centred opening, a demo built mostly on style findings, an ambiguous ratio column, and Quick start buried after the custom Rule example.

Changes

  • Header: transparent light and dark logos in a <picture>, with the light logo as the fallback that PyPI shows. Made from the existing logo artwork and sized close to SQLBuild's header. The old sqlclean-logo.png stays, because the 0.1.0 PyPI page still loads it.
  • Opening: the headline and speed line stay prominent, followed by one navigation row and a short left-aligned intro.
  • Demo: re-recorded with the existing VHS tape setup, showing real output.
    • sqlclean check reports an unused CTE (safe fix), a custom Rule finding (no fix) and = NULL (unsafe fix).
    • sqlclean fix removes the CTE and formats the file, but leaves = NULL.
    • sqlclean fix --unsafe-fixes rewrites it to IS NULL.
  • Speed table: the ratio column is now "Time relative to sqlclean check". The numbers are unchanged, from the published benchmarks page.
  • Order: Quick start now comes straight after Speed.
  • RELEASING.md: explains merging one up-to-date pull request at a time, and how to recover a release pull request whose lockfile refresh was skipped.

Verification

  • PyPI-like renders on white and on GitHub dark (#0d1117) were inspected; dark mode picks the dark logo.
  • Demo frames at 8, 16 and 25 s are readable at README width.
  • All existing links return 200. The two new logo URLs resolve after merge.
  • No em or en dashes, and the hygiene check is clean.

ampagent and others added 2 commits October 31, 2026 06:17
Use transparent light and dark header logos in a picture element, with
the light logo as the fallback for PyPI. Merge the speed line and the
navigation into one centred block and make the intro left-aligned.
Re-record the check-fix demo to show a NULL comparison, a safe fix that
removes an unused CTE, a custom Rule finding, and the unsafe IS NULL fix
applied only with --unsafe-fixes. Name the ratio column "Time relative
to sqlclean check" and move Quick start after Speed.

Co-authored-by: Kevin Longe <kvlonge@gmail.com>
…ull request

Co-authored-by: Kevin Longe <kvlonge@gmail.com>
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying sqlclean with  Cloudflare Pages  Cloudflare Pages

Latest commit: 425f9cd
Status: ✅  Deploy successful!
Preview URL: https://d2422a83.sqlclean.pages.dev
Branch Preview URL: https://docs-readme-polish.sqlclean.pages.dev

View logs

@kvlonge
kvlonge merged commit 98dc78d into main Oct 31, 2026
14 checks passed
kvlonge added a commit that referenced this pull request Oct 31, 2026
* docs: polish the README header, opening, demo and benchmark table

Use transparent light and dark header logos in a picture element, with
the light logo as the fallback for PyPI. Merge the speed line and the
navigation into one centred block and make the intro left-aligned.
Re-record the check-fix demo to show a NULL comparison, a safe fix that
removes an unused CTE, a custom Rule finding, and the unsafe IS NULL fix
applied only with --unsafe-fixes. Name the ratio column "Time relative
to sqlclean check" and move Quick start after Speed.

Co-authored-by: Kevin Longe <kvlonge@gmail.com>

* docs: trim the README logo padding and explain recovering a release pull request

Co-authored-by: Kevin Longe <kvlonge@gmail.com>

---------
@kvlonge
kvlonge deleted the docs/readme-polish branch October 31, 2026 08:34
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.

2 participants