Skip to content

docs: add signed commits section to contributing guidelines - #2841

Merged
ashharrison90 merged 3 commits into
grafana:mainfrom
alebgl77:docs/signed-commits-guidelines
Aug 21, 2026
Merged

ashharrison90 merged 3 commits into
grafana:mainfrom
alebgl77:docs/signed-commits-guidelines

Conversation

@alebgl77

Copy link
Copy Markdown
Contributor

Fixes: #2823

Adds a Signed Commits section to CONTRIBUTING.md, modelled on the Grafana contributing guide as suggested in the issue.

Right now CONTRIBUTING.md documents the CLA and the conventional-commit title rules, but says nothing about commit signing. Contributors discover the requirement from the automated info box on their pull request, after they have already pushed.

The new section covers:

  • the requirement, and the fact that commits GitHub cannot verify will block a merge
  • links to the GitHub docs for enabling commit signature verification and for checking verification status
  • a rebase snippet for signing commits that are already on the branch

It sits directly after the CLA section, since both are gates a pull request has to clear before it can be merged, and it is listed in the table of contents.

The commit on this pull request is signed.

@alebgl77
alebgl77 requested review from a team as code owners August 20, 2026 15:57
@alebgl77
alebgl77 requested review from academo, andresmgot and leventebalogh and removed request for a team August 20, 2026 15:57
@alebgl77
alebgl77 requested review from eledobleefe and joshhunt and removed request for a team August 20, 2026 15:57
@grafana-catalog-project-bot grafana-catalog-project-bot Bot moved this from 📬 Triage to 🔬 In review in Grafana Catalog Team Aug 20, 2026
@sunker
sunker requested a lite review from Copilot August 21, 2026 06:45

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.

Pull request overview

Adds signed-commit requirements and guidance to CONTRIBUTING.md.

Changes:

  • Documents signing requirements and verification links.
  • Adds instructions for signing existing commits.
  • Adds the section to the table of contents.
Suppressed comments (1)

CONTRIBUTING.md:135

  • This adds a second complete copy of the Signed Commits section immediately after the one above, so the rendered guide repeats the entire policy and rebase instructions. Please remove this duplicate block and keep only one section.
## Signed Commits

Effective June 22, 2026, all Grafana Labs repositories [require signed commits](https://docs.github.com/en/repositories/configuring-branches-and-merges-in-your-repository/managing-protected-branches/about-protected-branches#require-signed-commits). Commits that GitHub cannot verify will block your pull request from being merged.

> **Note**

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

Comment thread CONTRIBUTING.md Resolved
Comment thread CONTRIBUTING.md Resolved

@ashharrison90 ashharrison90 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.

lgtm, thanks! 🙌

@ashharrison90
ashharrison90 merged commit b4bf688 into grafana:main Aug 21, 2026
29 checks passed
@github-project-automation github-project-automation Bot moved this from 🔬 In review to 🚀 Shipped in Grafana Catalog Team Aug 21, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

Archived in project

Development

Successfully merging this pull request may close these issues.

Update contributing guidelines for signed commits

4 participants