Repository navigation
docs: say "accessible" in Overview titles and define AX in one sentence - #88
Merged
alexgrozav merged 1 commit intoNov 17, 2026
Merged
Conversation
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>
3 of 4 tasks
alexgrozav
added a commit
that referenced
this pull request
Nov 17, 2026
…nce (#89) ## 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 - [x] The title follows [Conventional Commits](https://www.conventionalcommits.org), as in `feat(docs): add the focus guideline`. - [x] `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`.) - [x] Homepage changes: `pnpm build`, then `pnpm lighthouse`, still scores 100 in every category. --------- Co-authored-by: multica-agent <github@multica.ai>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What changed
Every component Overview now has a
seo.titleofAccessible <title> - guidelines, like "Accessible Button - guidelines", so search results say "accessible", which is what people type ("accessible button", "accessible combobox"). The page's<h1>, its markdown copy and itsllms.txtlink keep the component's name, "Button", since the MCP server heads the whole page with it. The 8 Overviews that already had aseo:block get the title inside it.The 68 layer pages separate their title parts with " - " rather than ": ", as in "Checkbox Group - Developer Experience (DX)", which stays at 42 characters, the longest title.
The Introduction's Agentic experience section (AX layer) now opens with a sentence that defines AX on its own: "Agentic experience (AX) is how well AI agents can read, reason about and build with a component." Its heading and four bullets are unchanged, since the plugin's skills and the MCP server read the headings.
AGENTS.mdand.github/CONTRIBUTING.md("The docs") use the dash example and state the Overview title rule.This builds on the previous change on this branch, which keeps an Overview's markdown copy and
llms.txtlink on itstitle.Checklist
feat(docs): add the focus guideline.pnpm check-typespasses. So dopnpm check-reference,pnpm test,pnpm check-seo(0 failures) andpnpm check-mcpafter both builds.pnpm dev. (Not run. I checked the built<title>,og:title, markdown copies andllms.txtindist/instead.)pnpm build, thenpnpm lighthouse, still scores 100 in every category. (No homepage changes.)