ci(wiki): add docs-to-wiki sync workflow and generator #857

Merged
chris merged 1 commit from feat/wiki-setup into main 2026-09-25 18:08:05 +02:00
Owner

Summary

  • New Forgejo Actions workflow Wiki Sync: on push to main it clones the repo wiki, regenerates curated docs pages via scripts/ci/sync-wiki.py, and pushes them (auth via new repo secret WIKI_TOKEN, already configured).
  • Wiki pages are flat (Forgejo wikis have no subdirectory support), so docs are flattened to prefixed pages: ADR-*, Dev-*, Changelog-*, Operator-*, plus Home/_Sidebar navigation.
  • ADRs migrated to JSON (2026-06) are rendered to markdown; links between curated docs are rewritten to flat page links.

Verification

  • Generator dry-run produced 102 pages (60 ADR, 6 Dev, 28 Changelog, 1 Operator + Home/_Sidebar/core docs)
  • No unresolved cross-page links except 1 intentionally-untouched link into specs/
  • YAML parses; push path smoke-tested against a scratch bare repo

After merge this run creates the initial wiki content automatically.

## Summary - New Forgejo Actions workflow `Wiki Sync`: on push to main it clones the repo wiki, regenerates curated docs pages via `scripts/ci/sync-wiki.py`, and pushes them (auth via new repo secret `WIKI_TOKEN`, already configured). - Wiki pages are flat (Forgejo wikis have no subdirectory support), so docs are flattened to prefixed pages: `ADR-*`, `Dev-*`, `Changelog-*`, `Operator-*`, plus `Home`/`_Sidebar` navigation. - ADRs migrated to JSON (2026-06) are rendered to markdown; links between curated docs are rewritten to flat page links. ## Verification - Generator dry-run produced 102 pages (60 ADR, 6 Dev, 28 Changelog, 1 Operator + Home/_Sidebar/core docs) - No unresolved cross-page links except 1 intentionally-untouched link into specs/ - YAML parses; push path smoke-tested against a scratch bare repo After merge this run creates the initial wiki content automatically.
ci(wiki): add docs-to-wiki sync workflow and generator script
All checks were successful
Build and Deploy / Detect changed services and test scopes (push) Successful in 4s
Build and Deploy / Smoke API and media worker (push) Has been skipped
Build and Deploy / Smoke web (push) Has been skipped
Build and Deploy / Smoke ML worker (push) Has been skipped
Build and Deploy / Smoke people worker (push) Has been skipped
Build and Deploy / Build postgres image (push) Has been skipped
Build and Deploy / Build plants worker image (push) Has been skipped
Build and Deploy / Build converter worker image (push) Has been skipped
Build and Deploy / Deploy postgres (push) Has been skipped
Build and Deploy / Build API image (push) Has been skipped
Build and Deploy / Build media worker image (push) Has been skipped
Build and Deploy / Build ML worker image (push) Has been skipped
Build and Deploy / Build people worker image (push) Has been skipped
Build and Deploy / Build web image (push) Has been skipped
Build and Deploy / Deploy API (push) Has been skipped
Build and Deploy / Deploy web (push) Has been skipped
Build and Deploy / Deploy media worker (push) Has been skipped
Build and Deploy / Deploy ML worker (push) Has been skipped
Build and Deploy / Deploy plants worker (push) Has been skipped
Build and Deploy / Deploy people worker (push) Has been skipped
Build and Deploy / Deploy converter worker (push) Has been skipped
Build and Deploy / Clean Docker build artifacts (push) Has been skipped
Wiki Sync / Sync wiki from docs (push) Has been skipped
Build and Deploy / Run scoped PR tests (push) Successful in 2m23s
b128588f11
Forgejo wiki pages are flat (no subdirectories supported), so the script
flattens the curated docs set into prefixed pages (ADR-*, Dev-*,
Changelog-*, Operator-*). JSON ADRs (migrated 2026-06) are rendered to
markdown. The workflow runs on push to main, clones the wiki repo, and
pushes regenerated pages via WIKI_TOKEN.
chris merged commit 5cbe9bc27c into main 2026-09-25 18:08:05 +02:00
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
chris/memories!857
No description provided.