Skip to content

ci: publish the API reference from the release workflow - #139

Merged
dazzatronus merged 1 commit into
mainfrom
ci/publish-api-reference
Sep 18, 2026
Merged

dazzatronus merged 1 commit into
mainfrom
ci/publish-api-reference

Conversation

@dazzatronus

Copy link
Copy Markdown
Contributor

Publish the API reference from the release workflow so the HTML reference and downloadable specifications stay aligned with the source.

The job uses GitHub OIDC for AWS credentials and waits for the release job. It remains disabled until AWS_DOCS_DEPLOY_ROLE_ARN is configured. DOCS_CLOUDFRONT_DISTRIBUTION_ID enables cache invalidation.

The vendored renderer installs runtime dependencies only; its compiled CSS is already included.

Verify: built the reference on Node 22 from a clean source export; parsed the bundled and three per-API specifications; confirmed the HTML contains no unresolved head-tag placeholder. Workflow YAML parses and git diff --check passes.

Risk: S3 synchronisation uses --delete, restricted to the docs/api/ prefix.

@dazzatronus dazzatronus self-assigned this Sep 18, 2026
@dazzatronus
dazzatronus merged commit 53958be into main Sep 18, 2026
1 check passed
@dazzatronus
dazzatronus deleted the ci/publish-api-reference branch September 18, 2026 17:16
@github-actions

Copy link
Copy Markdown

🎉 This PR is included in version 1.18.4 🎉

The release is available on:

Your semantic-release bot 📦🚀

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant