Skip to content

feat: promote Module 0 and Phases into a top-level Introduction section - #14

Merged
cner-smith merged 2 commits into
mainfrom
feat/introduction-section
May 29, 2026
Merged

feat: promote Module 0 and Phases into a top-level Introduction section#14
cner-smith merged 2 commits into
mainfrom
feat/introduction-section

Conversation

@cner-smith

Copy link
Copy Markdown
Collaborator

What

Moves the foundational Module 0 content and the three implementation Phases out of the Guides section into a new, fifth top-level Introduction section — so the orientation material is no longer buried inside Guides.

Top-level nav goes from four sections to five:

Introduction · Guides · Templates · Tools · Case Studies

Introduction sits first as the "start here" orientation section.

Changes

  • Moved files: docs/guides/{module-0,phase-1,phase-2,phase-3}/docs/introduction/..., giving clean URLs like /docs/introduction/module-0/.
  • New landing page for the section: docs/introduction/index.md.
  • Sidebar (astro.config.mjs): new top-level Introduction group holding the landing + curated Module 0 / Phase sub-groups. Guides collapses to a plain autogenerate now that its subfolders moved out.
  • Fixed broken internal links: the moved pages linked to /docs/module-0/ and /docs/phase-*/ — missing the parent path segment, so they previously 404'd. Now corrected to /docs/introduction/....
  • /docs landing page: added an Introduction card and repointed the primary hero action to "Start here" → Introduction.
  • site/README.md: updated throughout to document the new structure (folder map, file→URL table, sidebar explanation, the autogenerate duplication gotcha).

Notes

Pure information-architecture change — all page content, intra-folder slugs, and ordering are preserved.

URLs under /docs/guides/module-0/ and /docs/guides/phase-*/ change to /docs/introduction/.... Those pages weren't reachable via working links before (the in-content links were already broken), so external bookmarks are unlikely, but flagging it.

Verification

  • npm run build clean — 23 pages, no errors/warnings.
  • Parsed the built nav HTML: five top-level groups render in order; Module 0 (Overview + 6 pages) and Phases 1–3 nest under Introduction; Guides shows its landing + example-guide.
  • Swept all built HTML: zero stale /docs/guides/module-0, /docs/guides/phase-*, /docs/module-0, or /docs/phase-* references.

Move the foundational Module 0 content and the three implementation
Phases out of the Guides section into a dedicated, fifth top-level
"Introduction" section so the orientation material is no longer buried
inside Guides.

- Relocate docs/guides/{module-0,phase-1,phase-2,phase-3}/ to
  docs/introduction/ (clean URLs: /docs/introduction/module-0/, etc.).
- Add an Introduction section landing page (docs/introduction/index.md).
- Restructure the sidebar in astro.config.mjs: Introduction is a new
  top-level group (first in the nav) holding the section landing plus
  the curated Module 0 and Phase sub-groups; Guides collapses to a flat
  autogenerate now that its subfolders moved out.
- Fix internal cross-links in the moved pages, which previously pointed
  at /docs/module-0/ and /docs/phase-*/ (missing the parent segment, so
  they 404'd) -> now /docs/introduction/...
- Surface the new section on the /docs landing page (Introduction card,
  "Start here" hero action).
- Update site/README.md to document the new structure throughout.

Pure information-architecture change: all page content, slugs within
each folder, and ordering are preserved. Verified with a clean
`npm run build` (23 pages) and HTML nav inspection: five top-level
groups render, Module 0 and Phases nest under Introduction, and no
stale links remain.
Rewrite the Introduction section landing so it does not duplicate the
opening prose of module-0/index.md. Use each phase's own guiding
question and real coverage list (from the phase index files), and note
that the Phase pages are still outlines under development.
@cner-smith
cner-smith merged commit 5b07138 into main May 29, 2026
2 checks passed
@cner-smith
cner-smith deleted the feat/introduction-section branch May 29, 2026 13:34
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