Some wiki pages that clearly existed weren’t showing up on the docs site (https://delph-in.github.io/docs/) — most visibly, BergenTop was 404ing despite being linked from SummitTop. This is because the site generator only renders a page if it’s manually registered in sitesdefinitions.json, and that step is all too easy to miss.
With some help from Claude, I have tried to make this more automatic.
Fix (live now): the build now auto-registers any wiki page linked to from a page already on the site. BergenTop and 16 other previously-invisible pages (including the rest of this year’s Bergen summit pages) are live: DELPH-IN
Two PRs open for review:
- #161 — routine CI maintenance, bumping deprecated Action versions: CI hygiene: bump deprecated action versions by fcbond · Pull Request #161 · delph-in/docs · GitHub
- #162 — the flip side of the fix above: if a registered page’s wiki source is deleted, the build currently fails entirely until someone hand-edits the config. This prunes stale entries automatically instead (only after a page’s been missing for two separate runs, so a flaky checkout can’t wrongly delete a real page): Auto-prune registered pages whose wiki source has disappeared by fcbond · Pull Request #162 · delph-in/docs · GitHub
Feedback welcome, especially from @EricZinda, if I don’t hear from anyone by the end of the summit, I will merge these.
Francis