Commit Graph
9 Commits
Author SHA1 Message Date
ukimsanov f6d45c9a0d docs: drop the paragraph measure cap that was doing nothing
Checked it on the live preview instead of assuming: a whole guide page renders
about three <p> elements, because the content is lists, tables, cards, and code.
The selector matched one of them — the page description in the header — so the
rule capped nothing while reading as though it were load-bearing. Removed it and
corrected the width note in AGENTS.md, which claimed prose was held near 80
characters. The column measures 888px at 1600 and 1048px at 1920.
2026-07-29 15:04:03 -07:00
ukimsanov f2bd52650d docs: put the four front doors together, widen the column, drop accordions
Navigation: Start here now holds exactly the four entry points a person can be
sent - what it is, make one, choose a workflow, and the Studio overview. The
three pages that were sitting in it went where they belong: the project tour is
conceptual so it moved to Learn, authentication is configuration so it moved to
Developers, and the hosted AI-chat route is a creation surface so it moved to
Create with an agent.

Width: the theme capped the article shell at 72rem and reserved 28rem of every
wide viewport for the contents rail, leaving the reading column at ~664px on a
1600px screen - narrower than the 16:9 video the pages are supposed to show.
Raised the shell and returned 9rem from the gutter, taking the column to roughly
950px. Running prose is held near 80 characters because longer lines measurably
hurt reading; tables, cards, code, and media use the full width. Added .hf-wide
for visuals that should escape the measure entirely.

Components: the quickstart source chooser is now Tabs, which is what parallel
variants of one instruction want, and the help symptoms are visible sections with
their own anchors so support can link a symptom directly instead of the hub.
Wrote the doctrine into AGENTS.md - one component per job, cards never point at
anchors on their own page, no diagram that restates adjacent prose, and the rules
for custom React snippets (named exports, no third-party packages, no CDN).
2026-07-29 14:50:12 -07:00
ukimsanov 0f7acfe9c6 docs: prevent GitHub count navigation blink 2026-07-28 21:11:34 -07:00
ukimsanov 8bf97614fc docs: strengthen header stars and agent input 2026-07-28 20:58:57 -07:00
ukimsanov 5cdfb1e6a2 docs: align Aspen chrome with main 2026-07-28 20:46:20 -07:00
ukimsanov f3e5b7fc1b docs: match main sidebar navigation UX 2026-07-28 20:33:22 -07:00
ukimsanov a46ac9edb9 docs: correct navigation visual treatment 2026-07-28 20:23:26 -07:00
ukimsanov 2b1644ffd5 docs: restore default navigation behavior 2026-07-28 20:13:29 -07:00
ukimsanov f5201aa97c docs: refactor documentation around user workflows 2026-07-28 19:16:15 -07:00