Skip to content

feat(pages): het handboek publiceert weer, nu op GitHub Pages - #5

Open
MWest2020 wants to merge 1 commit into
mainfrom
feat/pages-publiceren
Open

feat(pages): het handboek publiceert weer, nu op GitHub Pages#5
MWest2020 wants to merge 1 commit into
mainfrom
feat/pages-publiceren

Conversation

@MWest2020

Copy link
Copy Markdown
Contributor

Sinds 2026-08-03 had de pipeline geen deploy-stap, met een goede reden: publiceren naar Codeberg zou een Codeberg-PAT als GitHub-secret vergen — een credential over twee forges heen. Die reden vervalt nu de site zelf naar GitHub verhuist: Pages werkt met het ingebouwde token en OIDC, dus er komt geen enkel nieuw secret bij.

  • mkdocs.yml: site_url naar https://conductionnl.github.io/handbook/. Dat veld stuurt de canonical-links en sitemap.xml — die wezen naar de bevroren Codeberg-site en waren precies de 6 bevindingen die de gerepareerde linkcheck meldde.
  • docs.yml: pages: write + id-token: write, een concurrency: pages-groep die lopende deploys niet afbreekt, een artifact-upload aan het eind van build, en een aparte deploy-job met environment: github-pages. Actions gepind op commit-SHA, zoals de rest van dit bestand.
  • Publiceren gebeurt alleen op push naar main, en needs: build betekent dat een rode gate niets live zet. Een PR bouwt en gate't wel.
  • docs/org/pipeline-rood.md: de sectie "De site is bevroren" vervangen door waar de site staat en wat wel en niet publiceert.

Wat je in de run gaat zien. De linkcheck meldt tot de eerste publicatie ~181 verwijzingen naar conductionnl.github.io die nog niet bestaan; de 6 Codeberg-404's zijn weg. Hij is niet blokkerend. Dat aantal terug naar nul ná de eerste deploy is precies de voorwaarde om hem hard te zetten — dat is een aparte wijziging.

Lokaal: 27 tests, mkdocs build --strict, freshness 0/90, sitemap wijst naar de nieuwe URL.

Nog te doen door een mens, na de merge: de oude pages-branch (Forgejo-restant) opruimen.

🤖 Generated with Claude Code

Sinds 2026-08-03 had de pipeline geen deploy-stap, met een goede reden:
publiceren naar Codeberg zou een Codeberg-PAT als GitHub-secret vergen.
Die reden vervalt nu de site zelf naar GitHub verhuist — Pages werkt met
het ingebouwde token en OIDC, dus er komt geen nieuw secret bij.

site_url om, artifact-upload aan het eind van build, en een aparte
deploy-job met environment github-pages. needs: build betekent dat een
rode gate niets live zet; alleen een push naar main publiceert.

De linkcheck meldt tot de eerste publicatie ~181 verwijzingen naar
conductionnl.github.io die nog niet bestaan. Hij is niet blokkerend, en
dat aantal terug naar nul is precies de voorwaarde om hem hard te zetten.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
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