Repository navigation
docs(mkdocs): migrate documentation portal to MkDocs, add D2 diagrams, bidirectional coverage links, and CI automation - #32
Merged
Conversation
…tion - Migrate documentation portal from Docsify to Material for MkDocs - Redraw 12 architectural diagrams in D2 with automated drift checks - Add bidirectional JaCoCo coverage links and dark mode diagram styling
shashankch
force-pushed
the
docs/mkdocs-d2-site-and-docs-sync
branch
from
October 3, 2026 07:37
b6b6bc6 to
5551e7d
Compare
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
1 participant
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.
Summary
Migrates the public documentation portal from legacy Docsify to Material for MkDocs, redraws 12 architecture diagrams using declarative D2 syntax with dark mode support, integrates bidirectional JaCoCo code coverage navigation, and adds automated CI/CD quality gates.
Key Changes
docs/diagrams/*.d2and SVGs) with offline vector icons and dark theme container styling fixes./coverage/quality gates portal and/coverage-report/interactive JaCoCo report with persistent back navigation../scripts/generate-diagrams.sh --check) and strict MkDocs build validation.Verification
./scripts/generate-diagrams.sh --checkpassed (zero drift across all 12 diagrams).mkdocs build --strictpassed (0 errors, 0 warnings).