Repository navigation
feat: keep Overview names in agent copies and add alternateName - #87
Merged
alexgrozav merged 1 commit intoNov 17, 2026
Merged
Conversation
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>
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
Search titles for the component Overviews are coming, like "Accessible Button - guidelines". This change makes sure they reach only search engines, and that agents keep reading each Overview by its component's name.
An Overview's markdown copy (
/raw/docs/components/<component>.md) and its link inllms.txtare now headed by itstitle, like "Button", whatever itsseo.title. The MCP server serves the same copy and heads it withtitle, andget-pagefinds the page's sections by that name, so a search title in the heading failspnpm check-mcp. Layer pages keep theirseo.title, like "Button: User Interface (UI)". The rule lives in one function,rawTitle()inserver/lib/raw.ts, which the raw middleware and thellms.txtplugin both call.rawPage()now takes the heading astitleand no longer readsseo.No Overview has a
seo.titleyet, so the built/raw/copies,llms.txtandllms-full.txtare byte for byte the same as before. Withseo.title: "Accessible Button - guidelines"added to the Button's Overview as a probe,check-mcppasses, the copy starts# Button,llms.txtlinks[Button], and the page's<title>is "Accessible Button - guidelines - Open Components".The homepage's
WebSiteJSON-LD node also gets"alternateName": "OpenComponents", the one-word name the wordmark shows, so search engines can match it to this site. The Schema.org validator shows 0 errors on it.Checklist
feat(docs): add the focus guideline.pnpm check-typespasses.pnpm dev. (No docs pages change.)pnpm build, thenpnpm lighthouse, still scores 100 in every category.