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

Add a contributing guide #6

Merged
merged 5 commits into from
May 1, 2020
Merged

Conversation

github-learning-lab[bot]
Copy link
Contributor

Step 8: Add a CONTRIBUTING guide

A contributing guide provides important information to those who are interested in helping you with your project. Without a contributing guide, they might not know what you need help with, how they can get started, or how you like to communicate.

Providing the baseline expectations for a contribution to your project makes it much easier for a new user to contribute to the growth and development of your project.

What to include

Like the user facing documentation, the contributing guidelines for every project will be very different. Let's keep our first iteration simple and focus on letting people know our system for labels. Don't worry, we'll talk more about labels after you make these edits.

⌨️ Activity: Adding CONTRIBUTING guidelines

You can follow the manual steps below, or accept the suggested change in the following comment.

  1. Edit CONTRIBUTING.md on this branch, or manually edit it in the Files Changed tab.
  2. Find the text marked DESCRIPTION PLACEHOLDER.
  3. Replace each placeholder with a description for each label.
  4. After editing the CONTRIBUTING.md file, scroll down and click the Commit changes button.

I'll respond when I detect a commit on this branch.

CONTRIBUTING.md Outdated Show resolved Hide resolved
Co-authored-by: github-learning-lab[bot] <37936606+github-learning-lab[bot]@users.noreply.github.com>
@github-learning-lab
Copy link
Contributor Author

Step 9: Add labels

The open source community uses labels to help organize issues and pull requests within their repositories. They also use them to identify issues and pull requests that are looking for contributions from newcomers or to highlight specific skills needed to respond to the request.

By default, a new GitHub repository comes with the following labels out of the box:

  • bug
  • duplicate
  • enhancement
  • help wanted
  • invalid
  • question
  • wontfix

These initial labels are awesome, but most maintainers add (or delete) labels to fit their project. Labels like first-timers-only make it easy for newcomers to find suitable issues and pull requests, but they also tell the world you are welcoming and supportive to new open source contributors.

⌨️ Activity: Adding labels to your repository

  1. On the top right side of this pull request view, find the section titled: "Labels".
  2. Click the gear icon.
  3. Notice the text field at the top says Filter labels.
  4. Type the name of the label you would like to create.
  5. You will see a selection that reads "Create a new label", select that option.
  6. Customize your label with a description and color.
  7. Click Save.
  8. Add your new label to this pull request.

I'll respond when I detect a label on this pull request.

@jason-ocean jason-ocean added the first-starter good for beggining label May 1, 2020
@github-learning-lab github-learning-lab bot requested a review from jason-ocean May 1, 2020 15:44
@github-learning-lab
Copy link
Contributor Author

Step 10: Merge the CONTRIBUTING guide

Nice work @jason-ocean! You successfully added labels to this project. Labels will help Mona and her community keep things organized and quickly identify what an issue or pull request is trying to accomplish.

Go ahead and merge the CONTRIBUTING.md guide.

⌨️ Activity: Approve the pull request

  1. Clicking on this quicklink
  2. Select Approve
  3. Click Submit review.

You can also approve by clicking on Files changed, clicking on Review changes, selecting Approve and then Submit review.


I'll respond when you've approved this pull request.

@github-learning-lab github-learning-lab bot merged commit 1607015 into master May 1, 2020
@github-learning-lab
Copy link
Contributor Author

There are just a few more things left to do. First, you need to let the world know how they can use Mona's project and second, you need to let them know the kind of behavior Mona expects.

Mona has done a ton of research on licenses, let's see which one she has selected.


Go to the pull request here.

@jason-ocean jason-ocean deleted the add-contrib-guide branch May 1, 2020 15:46
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
first-starter good for beggining
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants