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

[META] Contributing Guide Revamp #24705

Closed
wants to merge 11 commits into from

Conversation

hramos
Copy link
Contributor

@hramos hramos commented May 3, 2019

Summary

This is the first step in revamping the Contribution Guide at /CONTRIBUTING.md. This work will require changes to the React Native website repository, as well as the React Native GitHub wiki. For review purposes, changes to copy that exists outside of this repository will be included within a .github/wiki directory in this PR, but they are not intended to be part of the final PR that gets merged.

Changelog

[General] [Changed] - Contribution Guide Revamp

Test Plan

N/A

@facebook-github-bot facebook-github-bot added CLA Signed This label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed. RN Team p: Facebook Partner: Facebook Partner labels May 3, 2019
@hramos hramos marked this pull request as ready for review May 8, 2019 21:07
@hramos hramos requested a review from cpojer as a code owner May 8, 2019 21:07
Copy link
Member

@rickhanlonii rickhanlonii left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Wow these docs are amazing, thanks @hramos!!

I left a bunch of minor comments for wording/formatting as I read, feel free to take any of the ones you like and reject any you don't 👍

@@ -0,0 +1,120 @@
# Your First Pull Request, a Step-by-Step Guide

These instructions provide the step-by-step process to set up your machine to make contributions to the core React Native repository, and create your first pull request.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
These instructions provide the step-by-step process to set up your machine to make contributions to the core React Native repository, and create your first pull request.
These instructions provide a step-by-step process to set up your environment and create your first React Native pull request.
  • Minor re-wording


### 2. Get the source code

While you can browse the source code for React Native on [GitHub][facebook/react-native], we recommend you set up a fork on your local machine.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
While you can browse the source code for React Native on [GitHub][facebook/react-native], we recommend you set up a fork on your local machine.
While you can browse the source code for React Native on [GitHub][facebook/react-native], we recommend you set up a fork on your local machine:
  • Switch to colon


While you can browse the source code for React Native on [GitHub][facebook/react-native], we recommend you set up a fork on your local machine.

1. Go to <https://github.com/facebook/react-native>.
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
1. Go to <https://github.com/facebook/react-native>.
1. Go to [https://github.com/facebook/react-native](https://github.com/facebook/react-native).
  • Convert to a link

2. Click on Fork on the upper right.
3. When asked, select your username as the host for this fork.

You will now have a fork of React Native on GitHub at <https://github.com/your_username/react-native>. Next, you will grab a copy of the source code for your local machine. Open a shell and type the following commands:
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Suggested change
You will now have a fork of React Native on GitHub at <https://github.com/your_username/react-native>. Next, you will grab a copy of the source code for your local machine. Open a shell and type the following commands:
You will now have a fork of React Native on GitHub at <https://github.com/your_username/react-native> and can copy the source code for your local machine.
Open a shell and type the following commands:
  • Whitespace and wording

.github/wiki/FirstPullRequest.md Outdated Show resolved Hide resolved
CONTRIBUTING.md Outdated Show resolved Hide resolved
CONTRIBUTING.md Outdated Show resolved Hide resolved
CONTRIBUTING.md Outdated Show resolved Hide resolved
CONTRIBUTING.md Show resolved Hide resolved
CONTRIBUTING.md Outdated Show resolved Hide resolved
hramos and others added 5 commits May 8, 2019 15:50
Co-Authored-By: hramos <165856+hramos@users.noreply.github.com>
Co-Authored-By: hramos <165856+hramos@users.noreply.github.com>
@hramos
Copy link
Contributor Author

hramos commented May 9, 2019

I've updated the Quip I based these on with the latest suggestions. Let's use that to work on any changes, and then I'll come back here and add them to the PR.

Copy link
Contributor

@facebook-github-bot facebook-github-bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@hramos is landing this pull request. If you are a Facebook employee, you can view this diff on Phabricator.

@react-native-bot
Copy link
Collaborator

This pull request was successfully merged by @hramos in a6f905f.

When will my fix make it into a release? | Upcoming Releases

@react-native-bot react-native-bot added the Merged This PR has been merged. label May 10, 2019
@hramos hramos deleted the contributing-master branch May 10, 2019 18:00
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
CLA Signed This label is managed by the Facebook bot. Authors need to sign the CLA before a PR can be reviewed. Merged This PR has been merged. p: Facebook Partner: Facebook Partner RN Team
Projects
None yet
Development

Successfully merging this pull request may close these issues.

5 participants