Skip to content

feat(docs): split the Tooltip page into an overview and a page per layer - #66

Merged
alexgrozav merged 1 commit into
component-sub-pages-uxf-421from
tooltip-sub-pages-uxf-434
Oct 22, 2026
Merged

alexgrozav merged 1 commit into
component-sub-pages-uxf-421from
tooltip-sub-pages-uxf-434

Conversation

@alexgrozav

Copy link
Copy Markdown
Contributor

What changed

The Tooltip's page becomes content/docs/3.components/tooltip/, shaped like the Button's: an Overview in index.md, then a page per layer, User Interface (UI), User Experience (UX), Developer Experience (DX) and Agentic Experience (AX), and a .navigation.yml that names the group and keeps the page's icon. It doesn't change what the standard says, so it isn't a guideline change for any one layer.

The Overview keeps the intro, At a glance, the Checklist's intro, the reference implementation and the sources. Four cards link the layer pages in place of the intro's list of layers, each with its page's new one-line description. At a glance now starts before the paragraph on how the examples work, then the paragraph on the Tooltip as one of the overlays, the playground and the table. Each layer page has its sections a level higher, then its rules under "UI Checklist" and so on, then its questions. Links to the page's own sections go to the layer page that now has them, like /docs/components/tooltip/ux#every-state. No other text changed.

The FAQ's questions went to the layer each one answers:

  • User Interface: "Can a tooltip stay dark in dark mode?", "Can I turn the arrow off?" and "Which browsers support the top layer and anchor positioning?"
  • User Experience: "Tooltip or something else?", "Can a tooltip hold a link?", "Why not use the title attribute?" and "Why doesn't a tap open it?"
  • Developer Experience: none
  • Agentic Experience: "Why not aria-label, or aria-labelledby?"

The live examples are on the Overview (the playground), User Interface (three) and User Experience (one). Developer Experience and Agentic Experience have none, like the Button's.

Agents still read one page. /raw/docs/components/tooltip.md has the same headings in the same order as before, apart from the FAQ's two headings, which now come back grouped by layer, with the same rules, and /raw/docs/components/tooltip.yaml is the same contract apart from link targets.

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. (Checked on the built site through wrangler dev instead: the sidebar, the header's menu, the previous and next links, every live example, the Framework select and the links from before the split.)
  • Homepage changes: pnpm build, then pnpm lighthouse, still scores 100 in every category. (No homepage changes.)

The Tooltip's page becomes a folder shaped like the Button's: an Overview,
a page for each layer, and its own group in the sidebar. The text moved
as it was, apart from link targets, the cards in place of the intro's
list of layers, At a glance starting before the paragraph on examples,
and the list of the four checklists.

Co-authored-by: multica-agent <github@multica.ai>
@cloudflare-workers-and-pages

cloudflare-workers-and-pages Bot commented Oct 22, 2026 •

Copy link
Copy Markdown

🚀 Deploying Preview to Cloudflare 🚀

Preview URL: https://tooltip-sub-pages-uxf-434-opencomponents.blue-water-0397.workers.dev (commit 2863c08)

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://131bbc07-opencomponents.blue-water-0397.workers.dev 2863c08 2026-10-22T13:34:49.370Z Visit the dashboard ↗

@alexgrozav
alexgrozav merged commit 5699628 into component-sub-pages-uxf-421 Oct 22, 2026
5 checks passed
@alexgrozav
alexgrozav deleted the tooltip-sub-pages-uxf-434 branch October 22, 2026 14:08
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