Skip to content

Centralize docs publishing and remove repo-local GitHub Actions

Date: 2026-05-01 Status: Accepted

Context

The workspace had GitHub Actions workflows spread across multiple repositories for CI, SBOM generation, docs dispatch, and deployment. Those workflows were consuming GitHub Actions minutes, failing frequently, and producing more noise than useful signal.

Documentation is the only artifact that still needs to be published centrally. The workspace already has a dedicated docs hub repository, terraform-cloudflare-docs-sites, that builds a consolidated site at docs.vslice.net.

Decision

Disable repo-local GitHub Actions workflows across the workspace and keep a single docs publishing workflow in terraform-cloudflare-docs-sites.

Use the sites variable in variables.tf as the authoritative definition for which repositories are included in the consolidated docs build.

Consequences

  • GitHub Actions minutes drop to a single docs deployment workflow.
  • Source repositories no longer auto-publish docs when they change.
  • Publishing docs from another repository now requires pushing that repository first and then running the hub deploy workflow, or deploying locally from the docs hub repository.
  • The repo list used by Terraform and the build script is no longer duplicated.
  • Repo-by-repo test strategy and future CI/CD patterns must be reintroduced deliberately instead of growing back piecemeal.