Skip to content

Rework portfolio around current projects and technical writing - #2

Merged
sempervent merged 12 commits into
mainfrom
feat/portfolio-ia-restructure
Oct 1, 2026
Merged

sempervent merged 12 commits into
mainfrom
feat/portfolio-ia-restructure

Conversation

@sempervent

@sempervent sempervent commented Oct 1, 2026 •

Copy link
Copy Markdown
Owner

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

  • Registry-driven portfolio — data/projects.yaml feeds homepage current work, Projects, and documentation sites via scripts/generate_portfolio.py (validated in CI before mkdocs build --strict).
  • Homepage — keeps Geospatial Systems, Data, and Strange Machinery; surfaces PARQONAUT, dots, and NUMBRANE; writing and Just for Fun entry points without repeating the full nav tree.
  • Navigation — Home, Projects, Writing (doctrine, ADRs, best practices, deep dives, tutorials including Just for Fun), About. Removed overlapping Lab tab (redirect to Just for Fun).
  • BlackLake — Python blacklake and Rust s3-rust-data-portal listed separately (related names, different repos).
  • Personal scope — brief ORNL disclaimer on About/footer; less absolute “production-ready everywhere” language on landing copy.
  • Editorial — public pages trimmed to reduce portfolio/marketing voice, duplicate taxonomy explanations, and generator implementation details on visitor-facing pages.

Taxonomy

Redirects

  • projects.md → projects/index.md
  • lab/index.md → Just for Fun index
  • tutorials/python-development/js-glitch-observatory.md → Just for Fun path

Validation

python scripts/validate_projects.py
python scripts/generate_portfolio.py
mkdocs build --strict
pytest tests/ -q

Follow-up

  • Restore broken org Pages deploys (mqtt-comparison, colony, …) and add to documentation-sites when they serve again.

sempervent 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.
@github-actions

github-actions Bot commented Oct 1, 2026

Copy link
Copy Markdown

📚 Documentation preview built successfully! The site has been generated and is ready for review.

@sempervent
sempervent merged commit 9b41a86 into main Oct 1, 2026
3 checks passed
@sempervent
sempervent deleted the feat/portfolio-ia-restructure branch October 1, 2026 03:07
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.

1 participant