Skip to content

Add PDF generation pipeline, update trigger/generate-html to latest template format - #385

Merged
recrwplay merged 1 commit into
devfrom
add-pdf-pipeline
Oct 8, 2026
Merged

recrwplay merged 1 commit into
devfrom
add-pdf-pipeline

Conversation

@recrwplay

Copy link
Copy Markdown
Contributor

Summary

  • Adds docs-generate-pdf.yml, calling reusable-docs-pdf-build.yml@v2 (same pattern as docs-getting-started and docs-template). This docset has a real version (antora.yml), so no versionless flag is needed.
  • Updates docs-trigger-builds.yml to the latest template format, dispatching both docs-generate-html.yml and the new docs-generate-pdf.yml. Kept all four push-triggering branches this repo already had (dev, main, 5.x, 4.4).
  • Refreshes docs-generate-html.yml to the latest shape: publish-env is resolved per-run inside the dispatched workflow via workflow_dispatch inputs, rather than a push-time matrix job - matching every other repo already migrated to this template.
  • Dropped the publish-html job's "If this step runs then approval has been granted" echo step - it wasn't gated by any real GitHub Environment protection rule (checked the repo's environments via the API: no branch/reviewer policy references prod), so it was dead code.

Test plan

  • vars.DOCS_DEV_BRANCH/DOCS_PROD_BRANCH already set correctly (dev/main) for this repo.
  • No js-yaml override in package.json to conflict with the PDF pipeline's Antora requirement, unlike the issue hit in docs-template.
  • Will confirm end-to-end once merged by watching the triggered docs-generate-pdf.yml run.

…emplate format

- docs-trigger-builds.yml now dispatches both docs-generate-html.yml and the new
  docs-generate-pdf.yml, keeping all four push-triggering branches (dev, main,
  5.x, 4.4).
- docs-generate-html.yml refreshed to the latest docs-template shape: per-run
  publish-env resolution via workflow_dispatch inputs rather than a push-time
  matrix job, matching every other repo already migrated. Dropped the dead
  "approval granted" echo step - no GitHub Environment protection rule actually
  gates it.
- docs-generate-pdf.yml added, calling reusable-docs-pdf-build.yml@v2 and
  handing off to docs-publish the same way docs-generate-html.yml already
  does. This docset has a real version (antora.yml), so no versionless flag.
@neo4j-docops-agent

neo4j-docops-agent commented Oct 8, 2026 •

Copy link
Copy Markdown
Collaborator

Thanks for the documentation updates.

The preview documentation has now been torn down - reopening this PR will republish it.

@recrwplay
recrwplay merged commit 88a5b89 into dev Oct 8, 2026
4 checks passed
@recrwplay
recrwplay deleted the add-pdf-pipeline branch October 8, 2026 10:18
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