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

chore: Minor changes to contributing doc and pr template for conventional commits #12439

Merged
merged 3 commits into from
Apr 4, 2024

Conversation

cstyan
Copy link
Contributor

@cstyan cstyan commented Apr 2, 2024

Changes based on the fact that we're now using conventional commits, we no longer want contributors making changes to the changelog themselves + we should include the link to conventional commits doc in the PR template.

commits.

Signed-off-by: Callum Styan <callumstyan@gmail.com>
@cstyan cstyan requested a review from a team as a code owner April 2, 2024 21:02
Copy link
Contributor

@JStickler JStickler left a comment

Choose a reason for hiding this comment

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

[docs team] two small tweaks, otherwise LGTM.

CONTRIBUTING.md Outdated
1. Your PR documents upgrading steps under `docs/sources/setup/upgrade/_index.md` if it changes:
1. It starts with an imperative verb. Example: Fix the latency between System A and System B.
2. It uses Sentence case, not Title Case.
3. It has a clear description saying what it does and why. Your PR description will be present in the project' commit log, so be gentle to it.
Copy link
Contributor

Choose a reason for hiding this comment

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

Assuming that random apostrophe was meant to be a possessive?

Suggested change
3. It has a clear description saying what it does and why. Your PR description will be present in the project' commit log, so be gentle to it.
3. It has a clear description saying what it does and why. Your PR description will be present in the project's commit log, so be gentle to it.

CONTRIBUTING.md Outdated
1. It starts with an imperative verb. Example: Fix the latency between System A and System B.
2. It uses Sentence case, not Title Case.
3. It has a clear description saying what it does and why. Your PR description will be present in the project' commit log, so be gentle to it.
2. Your PR is well sync'ed with main
Copy link
Contributor

Choose a reason for hiding this comment

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

Suggested change
2. Your PR is well sync'ed with main
2. Your PR is well synched with main

Copy link
Collaborator

@trevorwhitney trevorwhitney left a comment

Choose a reason for hiding this comment

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

LGTM, but let's also remove the GH workflow that was acting on that add-to-release-notes label with this PR as well

@@ -9,8 +9,7 @@ Fixes #<issue number>
- [ ] Reviewed the [`CONTRIBUTING.md`](https://github.com/grafana/loki/blob/main/CONTRIBUTING.md) guide (**required**)
- [ ] Documentation added
- [ ] Tests updated
- [ ] `CHANGELOG.md` updated
- [ ] If the change is worth mentioning in the release notes, add `add-to-release-notes` label
Copy link
Collaborator

Choose a reason for hiding this comment

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

why don't we remove the action that was updating the release notes with this PR as well?

Copy link
Contributor Author

Choose a reason for hiding this comment

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

done, I also added a note that we need to update the docs about updating the release notes as well, I'm not sure what changes we need to make there at the moment

@pull-request-size pull-request-size bot added size/M and removed size/S labels Apr 3, 2024
@github-actions github-actions bot added the type/docs Issues related to technical documentation; the Docs Squad uses this label across many repositories label Apr 3, 2024
Signed-off-by: Callum Styan <callumstyan@gmail.com>
@cstyan cstyan merged commit 1f653f0 into main Apr 4, 2024
11 checks passed
@cstyan cstyan deleted the pr-template-cc branch April 4, 2024 23:10
rhnasc pushed a commit to inloco/loki that referenced this pull request Apr 12, 2024
…onal commits (grafana#12439)

Signed-off-by: Callum Styan <callumstyan@gmail.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
size/M type/docs Issues related to technical documentation; the Docs Squad uses this label across many repositories
Projects
None yet
Development

Successfully merging this pull request may close these issues.

None yet

3 participants