Repository navigation
Rework portfolio around current projects and technical writing - #2
Merged
Merged
Conversation
added 12 commits
September 30, 2026 22:35
Add maintainer recon for site IA, live GitHub Pages verification, and BlackLake lineage.
Introduce data/projects.yaml with validation and generation scripts for portfolio pages.
Generate portfolio, lab, and documentation-site indexes from the registry.
Lead with person and registry-driven current work; defer deep taxonomy below the fold.
Group doctrine and docs under Writing; add Projects, Lab, and About tabs with redirects.
Add ORNL disclaimer, soften absolute production claims, and fix project links.
Run registry validation before builds in CI and add pytest coverage for scripts.
Rewrite homepage, project registry summaries, and section intros; drop redundant Lab page.
Shorten public copy, drop registry exposition and empty project sections, trim About and Writing landing pages.
Shallow checkout caused git revision date warnings that fail strict builds.
|
📚 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
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.
Why
The site front page read like a documentation handbook: stale project emphasis, no single index of live project docs, and navigation that buried the person behind the writing.
What changed
data/projects.yamlfeeds homepage current work, Projects, and documentation sites viascripts/generate_portfolio.py(validated in CI beforemkdocs build --strict).blacklakeand Rusts3-rust-data-portallisted separately (related names, different repos).Taxonomy
Redirects
projects.md→projects/index.mdlab/index.md→ Just for Fun indextutorials/python-development/js-glitch-observatory.md→ Just for Fun pathValidation
Follow-up
mqtt-comparison,colony, …) and add to documentation-sites when they serve again.