Skip to content

chore(docs): Add commit, issue & PR guidelines #6022

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

Merged
merged 1 commit into from
Oct 24, 2022
Merged

Conversation

mydea
Copy link
Member

@mydea mydea commented Oct 24, 2022

Update CONTRIBUTING.md to include some guidelines on writing commits, using issues and PRs.

Rendered

@mydea mydea requested a review from a team October 24, 2022 08:24
@mydea mydea self-assigned this Oct 24, 2022
@mydea mydea requested review from Lms24 and lobsterkatie and removed request for a team October 24, 2022 08:24
@mydea mydea force-pushed the fn/contribution-docs branch from 368df53 to d59daf2 Compare October 24, 2022 08:32
<type>(<scope>): <subject> (<github-id>)
````

For example: `feat(core): Set custom transaction source for event processors (#5722)`.
Copy link
Member

Choose a reason for hiding this comment

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

l: Should we point out that this format only strictly has to apply to the squashed commit that we merge into master?

Asking because what I'm usually doing is that in the first commit of my branch, I use the <type>(<scope>): <subject> format but without any github id. For follow-up commits I usually don't stick strictly to the convention. Not saying that this is the best way to go but IMO, since we squash and get the chance to rewrite the message before merging, this is the only message that actually matters if that makes sense...

Copy link
Member Author

Choose a reason for hiding this comment

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

Yeah, good point, I also thought about this a bit.

Maybe add a part like:

The Github-ID can be left out until the PR is merged

Does that make sense?

Copy link
Member

Choose a reason for hiding this comment

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

Sounds good!

Update `CONTRIBUTING.md` to include some guidelines on writing commits, using issues and PRs.
@mydea mydea force-pushed the fn/contribution-docs branch from d59daf2 to c4e822e Compare October 24, 2022 14:40
@mydea mydea merged commit 31bf467 into master Oct 24, 2022
@mydea mydea deleted the fn/contribution-docs branch October 24, 2022 15:09
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants