Skip to content

feat: say "accessible" in component titles and define agentic experience - #89

Merged
alexgrozav merged 6 commits into
mainfrom
accessible-titles-uxf-798
Nov 17, 2026
Merged

alexgrozav merged 6 commits into
mainfrom
accessible-titles-uxf-798

Conversation

@alexgrozav

Copy link
Copy Markdown
Contributor

What changed

The component pages now say what people search for, and the site answers "what is agentic experience" in one sentence.

  • Every component Overview has a search title that says "accessible", like "Accessible Button - guidelines". Its markdown copy, its llms.txt link and the MCP server's copy keep the component's name (# Button), so agents find the page by name as before. The shared rule is rawTitle() in server/lib/raw.ts.
  • Every layer page title separates its parts with a dash, like "Button - User Interface (UI)". AGENTS.md and CONTRIBUTING.md give the new pattern and the Overview rule.
  • The homepage's WebSite JSON-LD has "alternateName": "OpenComponents", the one-word name people type from the wordmark.
  • The Introduction's "Agentic experience" section opens with a sentence that defines AX: "Agentic experience (AX) is how well AI agents can read, reason about and build with a component."

This lands #87 and #88.

Checklist

  • The title follows Conventional Commits, as in feat(docs): add the focus guideline.
  • pnpm check-types passes.
  • Docs changes: the pages read well on pnpm dev. (Not run. The built pages in dist/ were read instead: titles, markdown copies and llms.txt.)
  • Homepage changes: pnpm build, then pnpm lighthouse, still scores 100 in every category.

alexgrozav and others added 4 commits November 17, 2026 12:22
An Overview's markdown copy and its llms.txt link are headed by its title,
like "Button", even once it has a seo.title. The MCP server serves the
same copy, headed by the title, and get-page finds the page's sections by
that name, so a search title there would fail check-mcp. Layer pages keep
their seo.title. rawTitle() in server/lib/raw.ts holds the rule for both.

The homepage's WebSite node gets "alternateName": "OpenComponents", the
one-word name the wordmark shows and people search for.

Co-authored-by: multica-agent <github@multica.ai>
Give every component Overview a seo.title of "Accessible <title> - guidelines",
since people search for "accessible button" and an Overview's title is only the
component's name. Separate the layer pages' title parts with " - " rather than
": ", as in "Checkbox Group - Developer Experience (DX)".

Open the Introduction's Agentic experience section with a sentence that
defines AX on its own, and state the Overview title rule in AGENTS.md and
CONTRIBUTING.md.

Co-authored-by: multica-agent <github@multica.ai>
@alexgrozav
alexgrozav marked this pull request as ready for review November 17, 2026 10:42
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Nov 17, 2026 •

Copy link
Copy Markdown

🚀 Deploying Preview to Cloudflare 🚀

Preview URL: https://accessible-titles-uxf-798.opencomponents.dev, https://accessible-titles-uxf-798-opencomponents.blue-water-0397.workers.dev (commit 88c247b)

This URL reflects your latest Preview deployment

Preview Deployments by commit

Status Deployment URL Commit Updated (UTC) See this deployment's details
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://4d7f948f.opencomponents.dev, https://4d7f948f-opencomponents.blue-water-0397.workers.dev 88c247b 2026-11-17T12:01:23.804Z Visit the dashboard ↗
  • Build: Success ✅
  • Deployment: Success ✅

View logs ↗
https://05b19384.opencomponents.dev, https://05b19384-opencomponents.blue-water-0397.workers.dev 97f796e 2026-11-17T10:40:00.650Z Visit the dashboard ↗

Co-authored-by: multica-agent <github@multica.ai>
@alexgrozav
alexgrozav marked this pull request as draft November 17, 2026 11:49
@alexgrozav
alexgrozav marked this pull request as ready for review November 17, 2026 12:02
@alexgrozav
alexgrozav merged commit 567a300 into main Nov 17, 2026
5 checks passed
@alexgrozav
alexgrozav deleted the accessible-titles-uxf-798 branch November 17, 2026 12: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