Skip to content

docs: align commit conventions with commitlint and explain the changelog - #1050

Merged
EdwardMoyse merged 1 commit into
HSF:mainfrom
AnKiT-GaRG2:docs/commit-conventions-424
Nov 1, 2026
Merged

EdwardMoyse merged 1 commit into
HSF:mainfrom
AnKiT-GaRG2:docs/commit-conventions-424

Conversation

@AnKiT-GaRG2

Copy link
Copy Markdown
Contributor

Part of #424

Old behavior: CONTRIBUTING.md listed a misc commit type that commitlint (@commitlint/config-conventional) rejects, listed only two scopes, and did not say how commits, PR titles and the changelog relate.

New behavior: the documented types match what CI accepts, the scope list notes that package names are used, and a short section explains that the PR title is validated, becomes the commit message on squash merge, and that merge commits do not produce changelog entries.

Changes:

  • CONTRIBUTING.md: fix type and scope lists
  • CONTRIBUTING.md: add "Commits, pull request titles and the changelog"

The workflows already validate PR titles and commits, so this only documents the current setup. I left the issue open in case maintainers want more, for example a PR-based changelog tool.

@github-actions

Copy link
Copy Markdown

🚀 Preview deployed: http://phoenix-pr-1050.surge.sh

Built from 072ddba.

@EdwardMoyse
EdwardMoyse merged commit 10f6257 into HSF:main Nov 1, 2026
4 checks passed
@EdwardMoyse

Copy link
Copy Markdown
Member

Thank you very much - this is great!

This branch was successfully deployed

1 active deployment
pull-request — 072ddba9 Deployed Oct 30, 2026 by github-actions[bot]
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