PROCESS CHANGE: New Contributor Guideline
- Dominant language
- Go
- Stars
- 292
- Forks
- 254
- Avg merge
- 18h 11m
- Merged PRs (30d)
- 1
Description
In the Knative Eventing community, we've been thrilled to see a surge in active contributions from new members. This influx of enthusiasm is a positive sign of growth. However, it has also brought to light certain challenges.
A persistent challenge we face involves new contributors who ambitiously take on several issues at once (typically two or more) but subsequently become inactive, often without communication for extended periods. This pattern not only delays progress on these issues but also places an undue burden on our maintainers. Our maintainers are tasked with overseeing progress and ensuring project momentum, and such unresponsiveness disrupts these efforts. Currently, our approach to address this involves sending follow-up messages to these contributors, requesting updates. In cases where no response is received, our next step is to unassign them from the issue. This process, while necessary, adds to the workload of our maintainers, underscoring the need for a more effective solution.
Take Knative Eventing as an example:
Right now in the [contribution.md](https://github.com/knative/eventing/blob/main/CONTRIBUTING.md), there is nothing to tell the contributors how to contribute and any "rules" that we have.
During a recent Eventing Working Group meeting, we discussed how to address this dilemma more effectively. Key suggestions included:
1. Issue Assignment Limit: Set a cap on the number of issues a new contributor can assign to themselves at a time. For example, limit new contributors to a certain number of issues at a time. This can be measured by the submission of pull requests (PRs). For instance, once a contributor has submitted a PR for one of their assigned issues, they are allowed to take on an additional issue.
2. Documentation : Clearly document these guidelines in our 'contribution.md' file and in the existing "Getting Started in Open Source with Knative" blog post by Calum and Leo.
3. Communication: If a contributor has an issue assigned but has not made visible progress (like commenting, discussing, or submitting a PR) for more than a certain number of weeks, send reminders or check-in messages. If still not hearing back from them 1 week after check-in message, they will be unassigned from the issue.
We are open to discussion and hope to get more insight from the TOC and community to find a better way to accommodate this.
@creydr @Cali0707 @pierDipi @aliok
Contributor guide
Research direction
Start by reviewing CONTRIBUTING.md and the existing “Getting Started in Open Source with Knative” blog post. Consult the referenced Eventing Working Group discussion and community stakeholders to define the assignment, progress, and communication guidelines. Done means the agreed process is documented in both locations.
Written by the indexing model from the issue text.
Assessment
- Domain
- documentation
- Issue type
- Documentation
- Difficulty
- 5/5
- Estimated time
- Over a week
- Activity status
- Stale
- Clarity
- Needs clarification
- Newbie friendliness
- 25/100