Skip to content

ci(deps): list dependency updates under Maintenance in the changelog - #273

Merged
dermatz merged 2 commits into
mainfrom
ci/deps-maintenance-changelog
Nov 6, 2026
Merged

dermatz merged 2 commits into
mainfrom
ci/deps-maintenance-changelog

Conversation

@dermatz

@dermatz dermatz commented Nov 6, 2026

Copy link
Copy Markdown
Member

Summary

Dependency updates currently show up under Added in the changelog (see the 0.29.0 release PR), because Dependabot copies the style of recent commits and titles its PRs feat(deps): ... / feat(deps-dev): .... That also triggers a minor version bump and the Feature label for plain dependency bumps.

Changes

  • .github/dependabot.yml: set commit-message.prefix: deps for the composer and github-actions ecosystems, so PRs are titled deps: ....
  • release-please-config.json: new changelog section deps -> Maintenance (visible). chore stays hidden, so linter upgrades and similar chores do not clutter the release notes.
  • CONTRIBUTING.md and docs/development.md: document the deps: type.

Notes

Testing

  • release-please-config.json parses as valid JSON.
  • trunk check on the four changed files reports no issues.
  • The Dependabot behaviour itself cannot be tested locally and will only show with the next Dependabot PR.

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Copilot AI balanced review requested due to automatic review settings November 6, 2026 11:59
@github-actions github-actions Bot added the documentation Improvements or additions to documentation label Nov 6, 2026
…guidance

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@github-actions github-actions Bot added the CI/CD label Nov 6, 2026

Copilot AI 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.

🟡 Changes recommended

The PR title workflow still rejects the new deps prefix, causing Composer and GitHub Actions Dependabot PRs to fail the check until its allowed-type pattern and diagnostic message are updated.

1 open issue
What changed in this PR

This PR gives Dependabot updates a dedicated deps: type so Release Please lists them under Maintenance rather than Added.

Changes:

  • Set the deps commit-message prefix for Composer and GitHub Actions updates.
  • Add a visible Maintenance changelog section while keeping chore hidden.
  • Document the new type and its expected patch-version behaviour.
File Description
release-please-config.json Map deps to the visible Maintenance section.
docs/​development.md Add deps: to the changelog section reference.
CONTRIBUTING.md Document dependency updates and expected versioning.
.github/​dependabot.yml Set both ecosystems to use the deps prefix.

Review effort: Balanced

Comment thread .github/dependabot.yml
# Without an explicit prefix Dependabot copies the style of recent commits
# and ends up with "feat(deps)", which shows up under "Added".
commit-message:
prefix: deps
Copilot AI balanced review requested due to automatic review settings November 6, 2026 12:01

Copilot AI 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.

🟡 Changes recommended

The guide permits plain merges that can omit deps: PRs with non-conventional commits from the changelog, so it should retain the squash-merge requirement and require the valid PR title as the squash commit message.

2 open issues

Review effort: Balanced

Comment thread CONTRIBUTING.md Resolved
@dermatz
dermatz merged commit a73741e into main Nov 6, 2026
22 checks passed
@dermatz
dermatz deleted the ci/deps-maintenance-changelog branch November 6, 2026 12:19
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

CI/CD documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants