fix(home): improve homepage semantics

[nibzard]

What changed

• keep Steel Documentation as the visible title and promote it to the page h1
• add a concise, answer-first definition of Steel beneath the title
• preserve the existing shader, spacing, card grids, ordering, and heading styles
• give each visible section an h2 and a unique anchor
• add a screen-reader heading for the initial getting-started and API cards
• align the site metadata description with the visible product definition
• prevent the 188×188 animated logo from shrinking beside the longer description
• add raw-HTML regressions for the heading outline, copy, anchors, and fixed logo size

Why

The homepage began at h3, reused the same anchor ID across three sections, and described the docs without directly explaining what Steel is. That weakened the page outline and made the primary answer harder for search engines and AI systems to extract.

The longer product definition also increased flex pressure beside the animated logo. Its inline dimensions remained 188×188, but the flex item could shrink. The new shrink-0 contract preserves its rendered size.

Impact

The page keeps its existing visual construction and navigation. Its raw HTML now has one clear title, a complete section hierarchy, unique anchors, and a concise product definition. The animated logo retains its original size.

Validation

• bun run check --error-on-warnings
• bun run typecheck
• bun run validate-links
• bun run build
• bun test tests/e2e/llm-endpoints.test.ts — 20 passed
• git diff --check

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
docs	Ready	Preview	Jul 30, 2026 5:33pm