Conversation
There was a problem hiding this comment.
Pull request overview
This PR reorganizes the documentation tree by promoting the new docs set under docs/ while archiving the legacy documentation set under old_docs/, aligning the GitHub Pages site with a clearer user/devops split.
Changes:
- Add a new dual-lane documentation set (Getting Started / User Guide / DevOps Guide) plus a
dev_docs/engineering namespace. - Archive prior docs and completed plan artifacts under
old_docs/. - Update GitHub Pages navigation (
docs/_config.yml) and refresh Minima custom styling.
Reviewed changes
Copilot reviewed 31 out of 49 changed files in this pull request and generated 1 comment.
Show a summary per file
| File | Description |
|---|---|
| old_docs/pipeline-diagram.md | Archived CLI/pipeline reference content. |
| old_docs/index.md | Archived legacy docs homepage. |
| old_docs/completed_plans/WORK_SCHEDULE_2026.md | Archived completed schedule plan. |
| old_docs/completed_plans/README.md | Archived completed plans index. |
| old_docs/completed_plans/JINJA2_AST_EXPANSION_WORKOFF_PLAN.md | Archived completed workoff plan. |
| old_docs/completed_plans/COVERAGE_WORKOFF_PLAN.md | Archived completed coverage plan. |
| old_docs/ci-starter-workflows.md | Archived CI starter guidance. |
| old_docs/article.htm | Archived legacy long-form HTML article. |
| old_docs/_sass/minima/custom-styles.scss | Archived legacy Minima theme overrides. |
| old_docs/_config.yml | Archived legacy Jekyll config snapshot. |
| old_docs/TODO.md | Archived roadmap/TODO document. |
| old_docs/STYLE_GUIDE_SOURCES.md | Archived style-guide source list. |
| old_docs/STATIC_ANALYSIS_SCOPE_AND_NONGOALS.md | Archived scope/non-goals doc. |
| old_docs/README.md | Archived legacy docs maintenance notes. |
| old_docs/PROVENANCE_TRACKING.md | Archived provenance tracking technical plan. |
| old_docs/PRISM_FRIENDLY_ROLE_GUIDE.md | Archived legacy role authoring guide. |
| old_docs/FEEDBACK_INTEGRATION.md | Archived legacy feedback integration spec. |
| old_docs/CONTRIBUTING.md | Archived legacy contributing guide. |
| old_docs/CODE_OF_CONDUCT.md | Archived legacy code of conduct text. |
| old_docs/CHANGELOG.md | Archived legacy changelog. |
| old_docs/ANNOTATION_QUALITY_WORKOFF_PLAN.md | Archived completed annotation quality plan. |
| docs/index.md | Rewritten docs homepage with learning order and audience tracks. |
| docs/README.md | Updated docs landing/overview for the new information architecture. |
| docs/_config.yml | Expanded header navigation to new docs pages. |
| docs/_sass/minima/custom-styles.scss | Updated Minima styling for new docs presentation. |
| docs/getting-started.md | New onboarding path for first scan + lane split. |
| docs/user-guide.md | New day-to-day workflow/task catalog. |
| docs/devops-guide.md | New CI/policy-oriented operational guide. |
| docs/provenance-tracking.md | New user-facing provenance overview. |
| docs/comment-driven-documentation.md | New marker/annotation usage guide. |
| docs/prism-friendly-role-authoring.md | New role authoring guidance page. |
| docs/feedback-integration.md | New feedback ingestion guide (prism-learn). |
| docs/changelog.md | New user-facing changelog page. |
| docs/code-of-conduct.md | New concise code of conduct page. |
| docs/knowledge-article.md | Rewritten long-form article as Markdown. |
| docs/dev_docs/README.md | New developer docs index page. |
| docs/dev_docs/architecture.md | New engineering architecture overview. |
| docs/dev_docs/cli-targets.md | New CLI subcommand intent/target matrix. |
| docs/dev_docs/ci-starter-workflows.md | New CI starter patterns (dev docs). |
| docs/dev_docs/static-analysis-scope.md | New engineering scope definition. |
| docs/dev_docs/provenance-tracking.md | New technical companion to provenance page. |
| docs/dev_docs/style-guide-sources.md | New engineering style sources reference. |
| docs/dev_docs/annotation-quality-workoff.md | New summarized annotation workoff page. |
| docs/dev_docs/completed-plans.md | New summarized archive pointer page. |
| docs/dev_docs/roadmap.md | New condensed roadmap summary. |
| docs/dev_docs/contributing.md | New concise contributor workflow. |
| docs/dev_docs/changelog.md | New developer-facing changelog page. |
| docs/dev_docs/source-evaluation-matrix.md | New matrix mapping legacy docs → new destinations. |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| header_pages: | ||
| - index.md | ||
| - getting-started.md | ||
| - user-guide.md | ||
| - provenance-tracking.md | ||
| - comment-driven-documentation.md | ||
| - devops-guide.md | ||
| - prism-friendly-role-authoring.md | ||
| - feedback-integration.md | ||
| - changelog.md | ||
| - dev_docs/README.md |
There was a problem hiding this comment.
header_pages lists several Markdown files, but most of those pages (e.g., getting-started.md, user-guide.md, dev_docs/README.md) don't have YAML front matter. In Jekyll, Markdown files without front matter are not processed into pages, so they won't appear in site.pages and the Minima header navigation can silently omit them (and links may serve raw .md). Add front matter (layout/title) to each listed page, or define Jekyll defaults and convert dev_docs/README.md to a proper page (e.g., index.md) so the navbar entries reliably render.
docs update