Skip to content

[CHORE]: Add CI workflow to make sure changelog gets updated with every PR - #5724

Merged
emilykl merged 6 commits into
mainfrom
add-changelog-check
Sep 10, 2026
Merged

[CHORE]: Add CI workflow to make sure changelog gets updated with every PR#5724
emilykl merged 6 commits into
mainfrom
add-changelog-check

Conversation

@emilykl

@emilykl emilykl commented Sep 9, 2026

Copy link
Copy Markdown
Contributor

Link to issue

Closes #5723

Description of change

Add a CI job to check that CHANGELOG.md is updated for every PR, unless the no-changelog label is added to the PR.

This implementation is pretty naïve; it only checks that CHANGELOG.md has been modified, not whether the new entry follows the correct format. Feel free to complexify in the future.

Demo

❌ Run failed (CHANGELOG.md not updated):
https://github.com/plotly/plotly.py/actions/runs/34384286059/job/102576548616

⚪ Run skipped (no-changelog label added):
https://github.com/plotly/plotly.py/actions/runs/34384435370/job/102577056340?pr=5724

✅ Run passed (CHANGELOG.md updated with dummy entry for demo purposes):
https://github.com/plotly/plotly.py/actions/runs/34385144520/job/102579417311?pr=5724

Guidelines

@emilykl emilykl added the no-changelog A changelog entry is not required for this PR label Sep 9, 2026
@emilykl emilykl removed the no-changelog A changelog entry is not required for this PR label Sep 9, 2026
@emilykl emilykl added the no-changelog A changelog entry is not required for this PR label Sep 9, 2026
@emilykl
emilykl requested a review from camdecoster September 9, 2026 17:54
@camdecoster camdecoster self-assigned this Sep 9, 2026

@camdecoster camdecoster left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Great idea! I left a few comments that I think will improve the check.

Comment thread .github/workflows/check-changelog.yml Outdated
Comment thread .github/workflows/check-changelog.yml
Comment thread .github/workflows/check-changelog.yml Outdated
jobs:
check-changelog:
name: Check if CHANGELOG.md was updated
if: ${{ !contains(github.event.pull_request.labels.*.name, 'no-changelog') }}

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

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

Could you add a message for the skipped and success cases? Also, could you also skip if the PR is in a draft state?

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Yes, will do

Copy link
Copy Markdown
Contributor Author

Choose a reason for hiding this comment

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

Addressed by 9d00782

@emilykl
emilykl merged commit 304fb76 into main Sep 10, 2026
27 of 28 checks passed
@emilykl
emilykl deleted the add-changelog-check branch September 10, 2026 21:20
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

no-changelog A changelog entry is not required for this PR

Projects

None yet

Development

Successfully merging this pull request may close these issues.

[CHORE]: Add CI step to check for changelog update

2 participants