Skip to content

Ask the docs site to regenerate its API reference after a release - #125

Merged
lambdalisue merged 1 commit into
mainfrom
feat/api-docs-dispatch
Oct 11, 2026
Merged

lambdalisue merged 1 commit into
mainfrom
feat/api-docs-dispatch

Conversation

@lambdalisue

Copy link
Copy Markdown
Member

Summary

  • After a (non-pre-release) Release publishes, a new update-api-docs job calls .github/workflows/update-api-docs.yml, which dispatches packages-published to probitas-test.github.io with {"packages": {"@probitas-test/probitas": "<version>"}}, using REPOSITORY_DISPATCH_TOKEN like the Homebrew update does. The workflow can also be run by hand.
  • The release rules mention the new step.

Why

The documentation site's API reference is generated from the npm packages, but nothing told it a release had happened, so it stayed behind until regenerated by hand. The site side (probitas-test/probitas-test.github.io) waits for the version to reach npm, regenerates, and opens a pull request.

Stacked on #124 (base chore/oss-init); it retargets to main when #124 merges and its branch is deleted.

Test Plan

  • actionlint
  • After merge: run "Update API Docs" by hand with {} and check the site opens or updates its pull request
  • Next release: the dispatch runs after publish

🤖 Generated with Claude Code

https://claude.ai/code/session_01N3xvJ1TaozjYSE6eoyo9mq

The documentation site's API reference is generated from the npm packages,
but nothing told it a release had happened, so the reference stayed behind
until someone regenerated it by hand. After publishing, the release now
dispatches `packages-published` to probitas-test.github.io with the versions
it published, the way it already asks the Homebrew tap to update; the site
regenerates and opens a pull request.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01N3xvJ1TaozjYSE6eoyo9mq
Copilot AI balanced review requested due to automatic review settings October 11, 2026 05:00

Copilot AI left a comment

Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

Base automatically changed from chore/oss-init to main October 11, 2026 05:12
@lambdalisue
lambdalisue merged commit 72c2fd0 into main Oct 11, 2026
6 checks passed
@lambdalisue
lambdalisue deleted the feat/api-docs-dispatch branch October 11, 2026 05:13
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