Skip to content

docs: point all docs links to undermountain.cc/labs/hermes-operator#12

Merged
Tombar merged 2 commits into
mainfrom
feat/docs-urls-undermountain-cc
Jun 2, 2026
Merged

docs: point all docs links to undermountain.cc/labs/hermes-operator#12
Tombar merged 2 commits into
mainfrom
feat/docs-urls-undermountain-cc

Conversation

@Tombar

@Tombar Tombar commented Jun 2, 2026

Copy link
Copy Markdown
Member

Docs are now published as a subsite of undermountain.cc (the web repo clones this repo, builds the MkDocs site, and serves it at /labs/hermes-operator/) instead of this repo's GitHub Pages.

Changes

  • URL swap (github.io → undermountain.cc/labs/hermes-operator): README (Quickstart / API reference / Examples), CONTRIBUTING, Helm chart NOTES.txt, and docs/mkdocs.yml site_url.
  • docs.yml repurposed: from build + deploy to GitHub Pages → a strict mkdocs build --strict check (broken-link/nav gate) on docs PRs. Drops pages:write/id-token:write and the deploy steps. Pages is no longer used (it was reset off when the repo was recreated), so the old deploy would have failed on merge anyway.

⚠️ Heads-up on CI

ci.yml and test-e2e.yml trigger on every PR to main with no path filters, so this docs-only PR will spin up the ~22-min E2E suite for no reason. Happy to add a paths-ignore: ['**.md', 'docs/**'] (or equivalent) to those workflows so doc-only changes skip the heavy Go/E2E runs — say the word and I'll fold it in here or as a follow-up.

🤖 Generated with Claude Code

Tombar added 2 commits June 2, 2026 14:26
The docs are now published as a subsite of undermountain.cc (cloned + built
by the web repo, served at /labs/hermes-operator/) rather than this repo's
GitHub Pages. Update every reference:

- README (Quickstart / API reference / Examples), CONTRIBUTING, the Helm
  chart NOTES.txt, and mkdocs.yml site_url -> undermountain.cc/labs/hermes-operator.
- Repurpose the Docs workflow from 'build + deploy to GitHub Pages' to a
  strict mkdocs build check (Pages is no longer used; publishing happens on
  the web side). Keeps the broken-link/nav gate on docs PRs, drops the
  pages:write/id-token perms and the deploy steps.

Signed-off-by: Tom Bar <martinloy.uy@gmail.com>
Public-launch prep:
- Swap all workflow runners from the self-hosted ucc-org-runners pool to
  ubuntu-latest. Self-hosted was only to dodge the Free-plan billing wall
  while private; public repos get free GitHub-hosted minutes.
- Add paths-ignore: ['**.md','docs/**'] to ci.yml + test-e2e.yml so doc-only
  PRs skip the Go build/lint and the ~20-min E2E suite.
- Add a disk-free step to the E2E job: ubuntu-latest has ~14GB free, and the
  suite pulls a 2.5GB image (+ a 2.5GB tar) plus Kind node images; reclaiming
  the preinstalled dotnet/android/CodeQL toolchains keeps it from filling up.

Signed-off-by: Tom Bar <martinloy.uy@gmail.com>
@Tombar Tombar merged commit 647c843 into main Jun 2, 2026
@Tombar Tombar deleted the feat/docs-urls-undermountain-cc branch June 2, 2026 17:37
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