Update contribution guidelines for pull requests - #11188
Open
lucassaldanha wants to merge 1 commit into
Open
Conversation
rolfyone
approved these changes
Aug 28, 2026
tbenr
approved these changes
Aug 31, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
PR Description
We have had many instances where “random” potential contributors submit PRs for areas unsolicited and without prior discussion, etc.
This is similar to what we saw a few years ago during the golden age of Airdrops. We even added a section explicitly outlining the types of PRs we would not accept, to prevent airdrop farming.
With the wide adoption of AI on development, we are likely to see more and more contributions to Teku, what puts us under pressure for reviews etc.
The changes to our CONTRIBUTING.md document are not meant to discourage people from contributing, but to ensure that us, maintainers, can keep up with the demand for reviews, while maintaining the quality of our codebase.
Here is a summary of some research I did on other projects with similar criteria, and some essays on this topic:
Fixed Issue(s)
N/A
Documentation
doc-change-requiredlabel to this PR if updates are required.Changelog
Note
Low Risk
Documentation-only change to contribution policy; no runtime, security, or build impact.
Overview
CONTRIBUTING.md now states explicitly that pull requests must be linked to an issue labeled
good first issueorhelp wanted, or to work a maintainer assigned to you. It adds a short workflow (open an issue → wait for triage → then open a PR) and says unrelated PRs will be closed with a pointer to that section, framed as managing review load rather than rejecting contributors.The former inline “airdrop farming” notes are grouped under a Airdrop Farming subsection. That list is reframed as examples that may be rejected even after an issue is opened, with small copy edits (e.g. “first-time”, “substantive”).
Reviewed by Cursor Bugbot for commit 1a28a28. Bugbot is set up for automated code reviews on this repo. Configure here.