Skip to content

CDMP Study-Site Upgrade Roadmap

This file is the durable upgrade sequence for the private GitHub study system. It exists so the work does not depend on chat memory.

Prerequisite issues — complete

  1. Chapter-home consistency ✅
  2. All 17 chapter home pages use the same quick-study navigation.
  3. Destinations: Study Home, Chapter Library, Learn, Exam Map, Visuals, Battle Cards, Scenarios, Questions, Recall, Local Source PDF, Formatted Originals.

  4. Chapter substantive content was preserved.

  5. Master Topic Finder ✅

  6. A–Z / concept-first index created so the learner can find a concept without remembering the chapter number.

  7. High-risk confusion pairs and major frameworks are routed to the best existing teaching/practice pages.

  8. “What should I study?” router ✅

  9. Routes are live for understanding gaps, confusion pairs, questions, recall, scenarios, review, timing, source verification and curriculum position.

  10. Existing chapter, cross-domain, 00C, and exam-conditioning materials are reused rather than duplicated.

  11. Repository-wide UX / link / orphan audit ✅

  12. Learner-facing navigation and source paths reviewed.
  13. Stale current-status/build wording repaired.
  14. Master Navigation, START HERE, 00C entrances, maintenance checkpoints and MkDocs navigation reconciled with the completed Chapters 1–17 mastery system.
  15. Audit closeout recorded at docs/maintenance/STUDY-SITE-UX-AUDIT.md.
  16. Regression checker retained at scripts/audit_study_site.py with .github/workflows/study-site-audit.yml.

Website-style interface upgrade — implemented

  1. Website-style interface upgrade ✅
  2. MkDocs Material is the private rendered-site shell around the existing source-grounded Markdown.
  3. Site navigation now exposes Home, Start Here, What Should I Study?, Topic Finder, DMBOK Mastery, all chapter study sections, 00C Execution, Meridian, and Master Contents.
  4. Every chapter is represented in the rendered navigation by Overview · Learn · Exam Map · Visuals · Battle Cards · Scenarios · Questions · Recall · Source & Originals.
  5. Program Study Home was redesigned as a purpose-first card dashboard.
  6. DMBOK Mastery Home was redesigned as a learning portal.
  7. Chapter Library was redesigned as an exam-weighted course catalog rather than a dense repository table.
  8. Custom CSS adds card surfaces, stronger hierarchy, readable tables/callouts, responsive layout, and calmer navigation treatment.
  9. All 17 Source panels now present the local GitHub DMBOK PDF first, the Drive source copy second, then the current formatted Drive originals.
  10. Search, breadcrumbs, in-page TOC, dark/light mode, sticky navigation, and previous/next footer behavior are enabled through MkDocs Material where pages participate in the site navigation.
  11. .github/workflows/build-private-study-site.yml builds and audits a private static site artifact named cdmp-private-study-site; it has no public deployment step.
  12. .devcontainer/devcontainer.json provides an authenticated GitHub Codespaces preview on port 8000 and starts mkdocs serve automatically.
  13. docs/private-study-site.md documents the Codespaces, private Actions artifact, and local-build paths.
  14. Public GitHub Pages remains intentionally disabled because licensed/private DMBOK material must not be exposed to an unrestricted public URL.

Validation note

The repository-side implementation is complete and the configuration files have been read back from main.

The first live authenticated Codespaces render still needs to be opened once by the repository owner because this connector cannot launch the user's Codespace/browser session. Treat that as a one-time visual validation, not as another content conversion or site rebuild. If that render exposes a visual or navigation defect, repair the specific defect; otherwise return to the learning-system roadmap.

Source rule

  • Current Google Drive chapter artifacts remain the formatted-original authority.
  • Each chapter's local source/original-dmbok-chapter.pdf is the private GitHub source copy.
  • GitHub Markdown is the searchable study/practice layer.
  • Artifact 08 remains performance-driven and should only reflect actual learner misses or weak performance.

Completion tracking

  • [x] 1 — Chapter-home consistency
  • [x] 2 — Master Topic Finder
  • [x] 3 — Study router
  • [x] 4 — Repository-wide UX/link/orphan audit
  • [x] 5 — Website-style interface upgrade

Next after the one-time visual validation

Do not keep rebuilding the interface merely because more polish is possible. Resume the actual Mastery Lab work:

  1. continue Stage 6 — Exam Conditioning;
  2. build Artifact 08 only from real learner performance;
  3. revisit interface work only when an observed usability problem or new study requirement justifies it.