Skip to content

docs: promote docs2 to docs and archive legacy docs as old_docs#25

Merged
mutl3y merged 1 commit into
mainfrom
docs
Mar 21, 2026
Merged

docs: promote docs2 to docs and archive legacy docs as old_docs#25
mutl3y merged 1 commit into
mainfrom
docs

Conversation

@mutl3y
Copy link
Copy Markdown
Owner

@mutl3y mutl3y commented Mar 21, 2026

docs update

Copilot AI review requested due to automatic review settings March 21, 2026 22:43
@mutl3y mutl3y merged commit 37b0f82 into main Mar 21, 2026
15 checks passed
Copy link
Copy Markdown

Copilot AI left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

Comment thread docs/_config.yml
Comment on lines 6 to +16
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
Copy link

Copilot AI Mar 21, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

Copilot uses AI. Check for mistakes.
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.

2 participants