Skip to content

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

Merged
alexgrozav merged 2 commits into
component-sub-pages-uxf-421from
input-sub-pages-uxf-429
Oct 22, 2026
Merged

alexgrozav merged 2 commits into
component-sub-pages-uxf-421from
input-sub-pages-uxf-429

Conversation

@alexgrozav

Copy link
Copy Markdown
Contributor

What changed

The Input page is now a folder shaped like the Button's, so readers get a page per layer rather than one long page. The Overview keeps the intro, At a glance, the Checklist's intro, the reference implementation and the sources, and links each layer from a card. The UI, UX, DX and AX pages hold their sections, then their rules under ## <Layer> Checklist, then their questions. The text moves as it is: agents still read one page at /raw/docs/components/input.md, with the same outline, rules and contract as before, and old links like /docs/components/input#every-state go on to the right part.

Links on the Input's own pages to its own sections now point to the part that holds them. Links to other components' sections, and other pages' links into the Input, are left for the layer that links the split pages to each other.

Each FAQ item went to the layer it answers:

  • User Interface: "Why is there no borderless variant?"
  • User Experience: "Input or something else?" (with its table), "Should I mark required fields, or optional ones?", "Can I use the browser's own validation?"
  • Developer Experience: "Does the Input work before JavaScript loads?", "Why doesn't the Input render its own label?"
  • Agentic Experience: none

The live examples went with their sections: the playground on the Overview, four on User Interface and five on User Experience. The Developer Experience and Agentic Experience pages have none.

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. (Read on the built site served by wrangler dev instead, with Chrome at 1440px and 375px.)
  • Homepage changes: pnpm build, then pnpm lighthouse, still scores 100 in every category. (No homepage changes. pnpm lighthouse passes the 0.95 budget, with Best Practices at 0.96.)

The Input page becomes a folder shaped like the Button's: an Overview with the intro, At a glance, the Checklist's intro, the reference implementation and the sources, and a page per layer, each ending with its rules and its questions. The text moves as it is, apart from the parts' descriptions, the cards, the Checklist's links and the links to the Input's own sections, which now point at the page each section lives on.
@alexgrozav
alexgrozav merged commit 74c0f1f into component-sub-pages-uxf-421 Oct 22, 2026
5 checks passed
@alexgrozav
alexgrozav deleted the input-sub-pages-uxf-429 branch October 22, 2026 13:21
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