Skip to content

feat: keep Overview names in agent copies and add alternateName - #87

Merged
alexgrozav merged 1 commit into
accessible-titles-uxf-798from
keep-overview-names-uxf-850
Nov 17, 2026
Merged

alexgrozav merged 1 commit into
accessible-titles-uxf-798from
keep-overview-names-uxf-850

Conversation

@alexgrozav

Copy link
Copy Markdown
Contributor

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 in llms.txt are now headed by its title, like "Button", whatever its seo.title. The MCP server serves the same copy and heads it with title, and get-page finds the page's sections by that name, so a search title in the heading fails pnpm check-mcp. Layer pages keep their seo.title, like "Button: User Interface (UI)". The rule lives in one function, rawTitle() in server/lib/raw.ts, which the raw middleware and the llms.txt plugin both call. rawPage() now takes the heading as title and no longer reads seo.

No Overview has a seo.title yet, so the built /raw/ copies, llms.txt and llms-full.txt are byte for byte the same as before. With seo.title: "Accessible Button - guidelines" added to the Button's Overview as a probe, check-mcp passes, the copy starts # Button, llms.txt links [Button], and the page's <title> is "Accessible Button - guidelines - Open Components".

The homepage's WebSite JSON-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

  • 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. (No docs pages change.)
  • Homepage changes: pnpm build, then pnpm lighthouse, still scores 100 in every category.

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>
@alexgrozav
alexgrozav merged commit a41ed1d into accessible-titles-uxf-798 Nov 17, 2026
5 checks passed
@alexgrozav
alexgrozav deleted the keep-overview-names-uxf-850 branch November 17, 2026 10:29
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>
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