Skip to content

docs: refresh marketing surfaces (landing, OG cards, gallery) to v1.2.0 - #173

Merged
johnnichev merged 1 commit into
mainfrom
docs/marketing-freshness
Jul 14, 2026
Merged

johnnichev merged 1 commit into
mainfrom
docs/marketing-freshness

Conversation

@johnnichev

Copy link
Copy Markdown
Owner

Follow-up to #172: the mkdocs docs were current, but the marketing surfaces lagged several releases:

  • landing/index.html: status bar + footer said v1.0.0 → v1.2.0; test counts 7,796 → 7,788 (current collected); the SEO JSON-LD and enterprise exhibit claimed "485 public symbols" — a v1.0-era number that no longer matches the audited surface (790 marked entries today) — reworded to the verifiable claim (every public symbol stability-marked, CI-enforced).
  • Social card (the big one): landing/assets/og-image.svg said v0.27.2 and the served og-image.png had never been regenerated — link previews for selectools.dev showed v0.20.1. SVG updated to v1.2.0 and the PNG re-rendered from it at exactly 1200×630 via headless Chromium (pixel-faithful, visually verified).
  • docs/assets OG card sources: "v1.0 · STABLE" → "v1.2 · STABLE".
  • landing/examples/index.html regenerated via scripts/build_examples_gallery.py (it embeds example sources; 23 and 29 gained sections in the feature PRs).
  • docs/CLAUDE.md: the gallery checklist pointed at a nonexistent landing/examples.json — corrected to the real path + regen command.

Also applied directly (not repo content): GitHub topics gained structured-output and observability.

https://claude.ai/code/session_01L1JWChKMs9yTyK92qquhJa

The landing page and social cards lagged several releases behind:

- landing/index.html: status bar and footer said v1.0.0; test counts said
  7,796 (now 7,788); the SEO JSON-LD and enterprise exhibit claimed "485
  public symbols" (a v1.0-era number that no longer matches the audited
  surface) - reworded to the verifiable claim (every public symbol
  stability-marked, CI-enforced).
- landing/assets/og-image.svg said v0.27.2 and the SERVED og-image.png
  was never regenerated and still showed v0.20.1. SVG footer updated to
  v1.2.0 and the PNG re-rendered from it at 1200x630 via headless
  Chromium (pixel-faithful to the original design, verified visually).
- docs/assets/og-image.svg + og-card.html badges: v1.0 -> v1.2 STABLE.
- landing/examples/index.html regenerated (embeds example sources; 23
  and 29 gained sections in the v1.1/v1.2 PRs).
- docs/CLAUDE.md: gallery pointer referenced a nonexistent
  landing/examples.json - corrected to the real path + regen command.

GitHub repo topics gained structured-output + observability (applied
directly, not repo content).

Claude-Session: https://claude.ai/code/session_01L1JWChKMs9yTyK92qquhJa
@johnnichev
johnnichev merged commit 694a889 into main Jul 14, 2026
9 checks passed
@johnnichev
johnnichev deleted the docs/marketing-freshness branch July 14, 2026 20:17
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