Repository navigation
Fix theme switching and clean up technical writing - #3
Merged
Merged
Conversation
added 3 commits
September 30, 2026 23:27
Replace prefers-color-scheme dual palettes with default/slate toggle so data-md-color-scheme stays aligned with CSS variables on project cards.
Replace synthetic Best Practices/Tutorials indexes, remove nav emoji, redirect duplicate Python guides, move integration walkthroughs to docs/archive (excluded from build), add writing audit/style guardrails, and strip Objective/weapon-of-choice lines across the corpus.
Skip browser regression unless RUN_THEME_TESTS=1; tighten card colors under .md-typeset; add capture script and maintainer screenshot evidence.
|
📚 Documentation preview built successfully! The site has been generated and is ready for review. |
Remove projects.md redirect that looped on /projects/, delete empty Tags nav/page and tags plugin with tags.md -> documentation.md redirect, remove writing-style.md, and add redirect map regression tests.
|
📚 Documentation preview built successfully! The site has been generated and is ready for review. |
Hardcoded styles in main.html and mis-placed extra_css prevented project-card theming from applying; use Material header/footer and scheme-scoped card vars. Strip maintainer artifacts, simplify About/Contact, and enforce theme tests.
|
📚 Documentation preview built successfully! The site has been generated and is ready for review. |
Delete docs/adr, diagram style guide, and repo-specific ADR governance page; strip ADR nav and cross-links; keep transferable Mermaid/SVG technical content.
|
📚 Documentation preview built successfully! The site has been generated and is ready for review. |
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
Fixes Material light/dark theming and project cards, cleans technical writing, removes routing/tags bloat, and drops site-meta documentation (ADRs, diagram policy, governance pages about this repo).
Theme (corrective pass — confirmed in review)
main.html(#fafafacards, blue:root) plusextra_cssnested undertheme:socustom.cssnever loaded in builds.main.html; delete custom header/footer; moveextra_cssto top-level; scheme-scoped project-card variables incustom.css; native Material palette switcher.tests/test_theme_palette.pyasserts computed card colors on home +/projects/(9/9 pytest, theme test not skipped).Site-meta documentation removed
docs/adr/corpus (not archived).adr-decision-governance.md,docs/diagrams/style-guide.md, and nav Architecture Decisions / diagram policy links.adr/index.md→documentation.md; deleted governance BP → architecture-design index.philosophy.mdis now Systems engineering principles (reader-facing, not “philosophy of the website”).docs/maintainers/and one-off audit scripts (prior commit).Routing — Projects redirect loop
Removed self-redirect
projects.md→projects/index.md. Regression intests/test_redirect_maps.py.Tags
Removed Tags nav/plugin;
/tags/→/documentation/.Writing cleanup (earlier commits on branch)
Corpus/index/boilerplate/integration archive — scope not expanded in meta-doc pass.
Test plan
validate_projects,generate_portfolio×2,lint_writingmkdocs build --strictpytest tests/ -q— 9 passed (includes theme browser test)test ! -d docs/adrandtest ! -d docs/maintainersManual: Home, Writing, Start Here, Projects, About, Contact — light/dark toggle; confirm no dead ADR links.
PR remains open for human review — do not merge from automation.