Skip to content

ci(docs): optimize doc build with caching and parallel generation#1373

Merged
hkad98 merged 2 commits intogooddata:masterfrom
hkad98:jkd/docs-ci-build
Feb 27, 2026
Merged

ci(docs): optimize doc build with caching and parallel generation#1373
hkad98 merged 2 commits intogooddata:masterfrom
hkad98:jkd/docs-ci-build

Conversation

@hkad98
Copy link
Contributor

@hkad98 hkad98 commented Feb 27, 2026

Summary

  • Add Go module and Hugo resource caching to both hugo-build-action and hugo-build-versioned-action composite actions to speed up doc builds
  • Optimize docs/Dockerfile with BuildKit cache mounts and better layer ordering so local dev rebuilds are faster
  • Add scripts for parallel versioned doc generation (discover-versions.sh, generate-single-version.sh, assemble-versions.sh) — extracted from the monolithic generate.sh to enable
    per-version matrix jobs
  • Add netlify-deploy-v2.yaml draft workflow that runs the new parallel architecture without affecting production — deploys to a Netlify draft URL for side-by-side validation

Rollout plan

  1. This PR (Phase 1+2): Caching improvements are additive and benefit the existing workflow immediately. The v2 workflow deploys as a Netlify draft (no --prod), so the live site is
    unaffected.
  2. Phase 3 (follow-up): After validating the draft output, swap netlify-deploy.yaml to the parallel architecture with --prod and delete the v2 file.
  3. Rollback: If Phase 3 fails, git revert the single swap commit restores the old workflow instantly.

Add Go module and Hugo resource caching to both hugo-build composite
actions. Optimize Dockerfile with BuildKit cache mounts and better
layer ordering. Add new scripts for parallel versioned doc generation
(discover-versions, generate-single-version, assemble-versions) — not
yet referenced by any workflow.

jira: trivial
risk: nonprod
Add netlify-deploy-v2.yaml that runs the new parallel matrix
architecture (discover → generate per-version → assemble + Hugo build)
but deploys as a Netlify draft (no --prod flag). This allows validating
the new build pipeline side-by-side with the existing production
workflow without any risk to the live site.

jira: trivial
risk: nonprod
@hkad98 hkad98 merged commit e9b05fe into gooddata:master Feb 27, 2026
6 checks passed
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.

2 participants