Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

ci: Workflow to check PR for conventional commit format #5528

Merged
merged 2 commits into from
Jun 27, 2024

Conversation

mofojed
Copy link
Member

@mofojed mofojed commented May 24, 2024

  • PRs will need to adhere to the conventional commit specification: https://www.conventionalcommits.org/en/v1.0.0/
  • If they do not, a comment will be added to the PR with details about the spec
  • Goal is to automate prettier release notes (e.g. separate Features from Fixes, highlight Breaking Changes). Could potentially be used for automated version bumping as well (which we do in deephaven-plugins, automatically bumping the correct version based on if there are breaking changes (major), features (minor), or fixes only (patch) in the release.
  • Follow up:
    • Add this check to branch protection
    • Use the commit history to automatically generate the changelog. In the deephaven-plugins repo, we use cocogitto, which also automatically bumps the version
    • Recommend to use PR_BODY and PR_TITLE for the default squash_merge_commit_mesage and squash_merge_commit_title respectively

I also noticed that with GitHub's automated release notes, you can actually configure it to use the labels to categorize PRs. That could be useful if there's hesitation to using conventional commits. One advantage of conventional commits is that you can easily handle automatic version bumping (we use cocogitto), which I don't think GitHub can do.

- PRs will need to adhere to the conventional commit specification: https://www.conventionalcommits.org/en/v1.0.0/
- If they do not, a comment will be added to the PR with details about the spec
- Follow up:
  - Add this check to branch protection
  - Use the commit history to automatically generate the changelog. In the deephaven-plugins repo, we use cocogitto, which also automatically bumps the version
  - Recommend to use PR_BODY and PR_TITLE for the default squash_merge_commit_mesage and squash_merge_commit_title
@mofojed mofojed added NoDocumentationNeeded NoReleaseNotesNeeded No release notes are needed. labels May 24, 2024
@mofojed mofojed self-assigned this May 24, 2024
@mofojed mofojed linked an issue May 24, 2024 that may be closed by this pull request
Copy link
Member

@devinrsmith devinrsmith left a comment

Choose a reason for hiding this comment

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

LGTM. I know there was some question of "when" to merge. I think the suggestion was after 0.35.0 is released.

@mofojed mofojed mentioned this pull request Jun 5, 2024
@mofojed mofojed merged commit 581d18e into deephaven:main Jun 27, 2024
15 checks passed
@mofojed mofojed deleted the conventional-pr-check branch June 27, 2024 15:31
@github-actions github-actions bot locked and limited conversation to collaborators Jun 27, 2024
Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
Projects
None yet
Development

Successfully merging this pull request may close these issues.

Open PR to enforce conventional commits in deephaven-core
3 participants