ci: update docs workflow triggers

[seanlanglands]

Description

This pull request updates workflows to ensure changelogs and documentation are published. The main changes involve triggering these workflows after a successful npm publish, ensuring that changelogs and documentation are kept in sync with releases.

Why didn't this work before?

Both the changelog.yml and publish-docs.yml workflows were configured to trigger on a new GitHub release being published. However, since the release is created programmatically via GitHub's API in another workflow (npm-publish.yml) and GITHUB_TOKEN is used, the event does not create subsequent workflow runs.

RE: https://docs.github.com/en/actions/how-tos/write-workflows/choose-when-workflows-run/trigger-a-workflow#triggering-a-workflow-from-a-workflow

Now, both docs-related workflows are invoked directly in npm-publish.yml to ensure they are run when the publish job is successful. If this job is skipped, the docs-related workflows are not run.

Pull request checklist

• Update SETUP.md with any new environmental variables.
• Update the documentation.
• Manually test the relevant changes.
• Follow the pull request checklist
• Add/update automated tests as needed.

New release checklist

• Automated tests pass.
• The Preparing for release checklist is completed.

[github-actions]

Dependency Review

✅ No vulnerabilities or license issues or OpenSSF Scorecard issues found.

Scanned Files

None

[Copilot]

Pull Request Overview

This pull request updates the workflow triggers to ensure changelogs and documentation are published after successful npm releases. The changes address a limitation where workflows triggered by GitHub releases created programmatically via GITHUB_TOKEN do not spawn subsequent workflow runs.

Key changes:

• Changed publish-docs.yml and changelog.yml triggers from release: [published] and push: tags to workflow_run based triggers
• Added two new jobs (changelog and publish-docs) in npm-publish.yml that directly invoke the documentation workflows
• Updated job and workflow naming for consistency

Reviewed Changes

Copilot reviewed 3 out of 3 changed files in this pull request and generated 3 comments.

File	Description
.github/workflows/npm-publish.yml	Adds two new jobs that invoke changelog and publish-docs workflows after successful publish
.github/workflows/publish-docs.yml	Changes trigger from tag push to workflow_run, adds job name
.github/workflows/changelog.yml	Changes trigger from release published to workflow_run, updates workflow and job names

---

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

[sjinks]

@seanlanglands, could you please check Copilot's comments?

[sonarqubecloud]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud

[seanlanglands]

@sjinks, that's now fixed. I switched to using workflow_call and re-tested this workflow setup on a test repo.