Skip to content

ci: notify the docs site on docs changes (repository_dispatch)#65

Open
daedmonds wants to merge 1 commit into
mainfrom
ci/notify-docs-site
Open

ci: notify the docs site on docs changes (repository_dispatch)#65
daedmonds wants to merge 1 commit into
mainfrom
ci/notify-docs-site

Conversation

@daedmonds

Copy link
Copy Markdown
Collaborator

On a push to main touching docs/ or assets/, sends a repository_dispatch (type docs-updated, payload {sha, ref}) to the marketing-site repo — its on-prem self-hosted "Publish documentation" runner then rebuilds + republishes /docs pinned to this commit. Instant instead of waiting up to an hour for the docs site's schedule.

Requires a repo secret DOCS_DISPATCH_TOKEN: a fine-grained PAT (machine account) or GitHub App token scoped to dataalgebra-engineering/burnside-project-marketing-site with Contents: Read and write (the minimum that authorizes a repository_dispatch).

Fail-open: if the secret is unset the job is a clean no-op (the hourly schedule still catches the change), so pg-cdc CI never breaks on a missing secret. Payload built with jq — never interpolated into the shell.

🤖 Generated with Claude Code

On a push to main touching docs/ or assets/, send a repository_dispatch (type
docs-updated, payload {sha, ref}) to the marketing-site repo, whose on-prem self-hosted
runner rebuilds + republishes /docs pinned to this commit — instant instead of waiting
for its hourly schedule.

Needs a repo secret DOCS_DISPATCH_TOKEN (fine-grained PAT / GitHub App scoped to the
marketing-site repo with Contents: write — the minimum to create a repository_dispatch).
Fail-open: if the secret is unset the job is a no-op (schedule covers it), so pg-cdc CI
never breaks. Payload built via jq, never interpolated into the shell.

Co-Authored-By: Claude Opus 4.8 (1M context) <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