feat: promote Module 0 and Phases into a top-level Introduction section - #14
Merged
Conversation
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.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
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 StudiesIntroduction sits first as the "start here" orientation section.
Changes
docs/guides/{module-0,phase-1,phase-2,phase-3}/→docs/introduction/..., giving clean URLs like/docs/introduction/module-0/.docs/introduction/index.md.astro.config.mjs): new top-levelIntroductiongroup holding the landing + curated Module 0 / Phase sub-groups.Guidescollapses to a plainautogeneratenow that its subfolders moved out./docs/module-0/and/docs/phase-*/— missing the parent path segment, so they previously 404'd. Now corrected to/docs/introduction/..../docslanding 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 buildclean — 23 pages, no errors/warnings./docs/guides/module-0,/docs/guides/phase-*,/docs/module-0, or/docs/phase-*references.