-
Notifications
You must be signed in to change notification settings - Fork 17
Add interacting w/ new contribs guide #50
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
Changes from 1 commit
Commits
Show all changes
6 commits
Select commit
Hold shift + click to select a range
b6f5fc0
add interacting w/ new contribs guide
kne42 2ab9d5c
Update content/maintainers/interacting-with-new-contributors.md
kne42 097521c
address feedback
kne42 8aee5fa
delete spacing
kne42 0fd139a
very useful commit message
kne42 19f36a3
Fix CI
jarrodmillman File filter
Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
There are no files selected for viewing
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
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
Original file line number | Diff line number | Diff line change |
---|---|---|
@@ -0,0 +1,66 @@ | ||
--- | ||
title: "How to interact with new community | ||
members" | ||
--- | ||
|
||
{{< notice warning >}} | ||
This is a draft document. | ||
{{< /notice >}} | ||
|
||
As a maintainer, you will be the first point of | ||
contact for new community members. It is important | ||
to embody a positive and helpful force for the | ||
health of your community. | ||
|
||
### Be welcoming | ||
Always behave polite, patient, and understanding. | ||
Many contributors are acting on their own time so | ||
try to create an environment that is energizing, | ||
not draining. | ||
|
||
Use language to show that you are excited and | ||
grateful about their contributions to the project. | ||
Avoid saying things that could be construed as | ||
meaning otherwise or being too short. | ||
|
||
Many first-time contributors are intimidated and | ||
nervous about making mistakes, so keep in mind for | ||
both you and them that mistakes are natural and | ||
part of the learning process. Assure and empower | ||
them with your help and mentorship so that they | ||
feel supported and comfortable contributing to the | ||
project. | ||
|
||
### Provide resources, not solutions | ||
While some level of shepherding is needed, be | ||
careful not to micro-manage contributors, as it | ||
hinders the learning process and can be | ||
frustrating for both parties. First offer guidance | ||
kne42 marked this conversation as resolved.
Show resolved
Hide resolved
|
||
before using more hands-on approaches. | ||
|
||
For tasks that may be too advanced or daunting for | ||
a first-time contributor, such as comprehensive | ||
testing, benchmarking, or doc-building, offer to | ||
handle that part or to lend your support while | ||
they try it themselves. | ||
|
||
Avoid excessive nitpicking as requesting constant | ||
small changes can be discouraging to a new | ||
contributor. Instead, you can make a follow-up PR | ||
after the merge to fix these or use an opinionated | ||
formatter, such as | ||
[`black`](https://github.com/psf/black), to handle | ||
most style-related nitpicks. | ||
|
||
### Recognize contributions | ||
Remember that contributions are a good thing that | ||
should be celebrated and encouraged. Communicate | ||
your appreciation for the work your community | ||
members are doing and connect the impact their | ||
contributions have to your project's goals and how | ||
it will help many others. | ||
|
||
By providing a positive contributing experience, | ||
you can create a positive feedback loop where | ||
community members enjoy and want to continue their | ||
amazing contributions to your project! |
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.
Uh oh!
There was an error while loading. Please reload this page.