Skip to content

Docs IA round 2: Primitives group + Get Started merge - #127

Merged
a6b8 merged 1 commit into
mainfrom
memo-144-docs-feinschliff
Jun 21, 2026
Merged

Docs IA round 2: Primitives group + Get Started merge#127
a6b8 merged 1 commit into
mainfrom
memo-144-docs-feinschliff

Conversation

@a6b8

@a6b8 a6b8 commented Jun 21, 2026

Copy link
Copy Markdown
Contributor

Closes #126. Companion to FlowMCP/flowmcp-spec#91 (consumes its regenerated payload).

Changes

  • Primitives nav group (src/data/sidebar.mjs): GROUP_LABELS + deterministic SPEC_GROUP_ORDER → Introduction → Core Specification → Primitives → Guides.
  • Get Started cluster (astro.config.mjs): merge standalone About group into Get Started; align Quickstart page H1 to its label CLI Setup + intro; add a For LLMs intro.
  • Sync the regenerated spec payload (Related descriptions, new Philosophy page, stripped post-intro dividers + conformance notes).
  • CSS safety-net for a stray post-intro divider (custom.css).
  • Sync Playwright route/marker specs to the new IA.

Verification

  • astro build 176 pages, no errors
  • internal-link audit: 3364 links / 0 broken
  • Playwright (navigation, phase-9-smoke, personas, a11y): green

Note: merge flowmcp-spec#91 first; this PR already bundles the synced output so its own build is self-contained. The actual GH-Pages deploy happens on merge to main.

- Primitives nav group (sidebar.mjs GROUP_LABELS + SPEC_GROUP_ORDER): Introduction -> Core Specification -> Primitives -> Guides
- merge standalone About group into Get Started; align Quickstart H1 to label 'CLI Setup' + intro; For LLMs intro
- sync regenerated spec payload (Related descriptions, Philosophy page, stripped dividers/conformance)
- CSS safety net for stray post-intro divider
- sync Playwright route/marker specs to new IA
astro build 176 pages, internal-link audit 3364/0 broken, Playwright green.
@a6b8
a6b8 merged commit ecf3952 into main Jun 21, 2026
4 checks passed
@a6b8
a6b8 deleted the memo-144-docs-feinschliff branch June 21, 2026 18:39
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.

Docs IA round 2: Primitives group + Get Started merge

1 participant