docs: automate docs publishing and upgrade docs UX #3

Merged
clawlter merged 1 commit from feat/docs-site-upgrade into main 2026-04-09 18:18:12 -04:00
Owner

Summary

  • redesign the mehalter.page docs site into a more task-first docs system with search, versioning cues, sidebars, on-page TOCs, copy buttons, and a new CLI reference
  • add docs-site validation with prettier, htmlhint, and impeccable anti-pattern checks
  • add automatic publication of the generated site to the pages branch on pushes to main

Verification

  • /opt/hermes-runtime/tools/mise/use-mise.sh uv run black --check src tests scripts
  • /opt/hermes-runtime/tools/mise/use-mise.sh uv run isort --check-only src tests scripts
  • /opt/hermes-runtime/tools/mise/use-mise.sh uv run pyright
  • /opt/hermes-runtime/tools/mise/use-mise.sh uv run pytest -q
  • /opt/hermes-runtime/tools/mise/use-mise.sh uv run python -m build
  • /opt/hermes-runtime/tools/mise/use-mise.sh npm run docs:test
## Summary - redesign the mehalter.page docs site into a more task-first docs system with search, versioning cues, sidebars, on-page TOCs, copy buttons, and a new CLI reference - add docs-site validation with prettier, htmlhint, and impeccable anti-pattern checks - add automatic publication of the generated site to the pages branch on pushes to main ## Verification - /opt/hermes-runtime/tools/mise/use-mise.sh uv run black --check src tests scripts - /opt/hermes-runtime/tools/mise/use-mise.sh uv run isort --check-only src tests scripts - /opt/hermes-runtime/tools/mise/use-mise.sh uv run pyright - /opt/hermes-runtime/tools/mise/use-mise.sh uv run pytest -q - /opt/hermes-runtime/tools/mise/use-mise.sh uv run python -m build - /opt/hermes-runtime/tools/mise/use-mise.sh npm run docs:test
docs: automate docs publishing and upgrade docs UX
All checks were successful
Docs site / Validate docs build, formatting, linting, and anti-patterns (pull_request) Successful in 2m1s
Python CI / Validate formatting, typing, and tests (pull_request) Successful in 2m34s
Docs site / Publish docs to mehalter.page (pull_request) Has been skipped
Python CI / Build source and wheel distributions (pull_request) Successful in 1m28s
1c2640588c
Sign in to join this conversation.
No reviewers
No labels
No milestone
No project
No assignees
1 participant
Notifications
Due date
The due date is invalid or out of range. Please use the format "yyyy-mm-dd".

No due date set.

Dependencies

No dependencies set.

Reference
clawlter/hermes-usage-insights!3
No description provided.