Skip to content

Commit f0f1f61

Browse files
Martin KonicekFacebook Github Bot 4
authored andcommitted
Update PR and issue templates and guidelines
Summary:- Simplified the PR and Issue template to make them easier to read. - Add a very simple guide for reviewing PRs (cc bestander, feel free to add to this) Closes facebook/react-native#6295 Differential Revision: D3011905 fb-gh-sync-id: 4929921690a6996e574e6b152a9dd41087cfffdc shipit-source-id: 4929921690a6996e574e6b152a9dd41087cfffdc
1 parent cf8bb75 commit f0f1f61

5 files changed

Lines changed: 23 additions & 26 deletions

File tree

CONTRIBUTING.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -73,6 +73,7 @@ Facebook has a [bounty program](https://www.facebook.com/whitehat/) for the safe
7373

7474
#### General
7575

76+
* **Most important: Look around.** Match the style you see used in the rest of the project. This includes formatting, naming things in code, naming things in documentation.
7677
* Add trailing commas,
7778
* 2 spaces for indentation (no tabs)
7879
* "Attractive"

ISSUE_TEMPLATE.md

Lines changed: 11 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -2,30 +2,20 @@ Hey there and thank you for using React Native!
22

33
React Native, as you've probably heard, is getting really popular and truth is we're getting a bit overwhelmed by the activity surrounding it. There are just too many issues for us to manage properly.
44

5-
Please read the following tips before filing an issue:
5+
Do the checklist before filing an issue:
66

7-
Is this something you can debug and fix?
8-
-------------------------------------------------------
7+
- [ ] Is this something you can **debug and fix**? Send a pull request! Bug fixes and documentation fixes are welcome.
8+
- [ ] Have a usage question? Ask your question on [StackOverflow](http://stackoverflow.com/questions/tagged/react-native). We use StackOverflow for usage question and GitHub for bugs.
9+
- [ ] Have an idea for a feature? Post the feature request on [Product Pains](https://productpains.com/product/react-native/). It has a voting system to surface the important issues. GitHub issues should only be used for bugs.
910

10-
Can you see anything in the logs? Can you debug why this happens? **Send a pull request**! Bug fixes and documentation fixes are very welcome.
1111

12-
Have a question or not sure you've found a bug?
13-
-----------------------------------------------------------------
14-
Please ask your question on [StackOverflow](http://stackoverflow.com/questions/tagged/react-native) with the tag `react-native`. StackOverflow is amazing for Q&A. Because of the reputation system it is likely the community will see and answer your question there.
15-
16-
Make sure you **include a short code snippet to demonstrate the problem**.
17-
18-
Have an idea for a feature?
19-
------------------------------------
20-
Post the feature request on [Product Pains](https://productpains.com/product/react-native/). It has a voting system that lets us focus on the most important issues the community is experiencing. The higher number of votes the more likely it is a feature will get implemented. You could always implement it yourself, too.
21-
22-
None of the above, want to create a GitHub issue
12+
None of the above, create a bug report
2313
------------------------------------------------------------------
2414

25-
Make sure to add **all the information needed to understand the issue** so that someone can help. If the info is missing we'll add the 'Needs more information' label and close the issue until there is enough information.
15+
Make sure to add **all the information needed to understand the bug** so that someone can help. If the info is missing we'll add the 'Needs more information' label and close the issue until there is enough information.
2616

27-
- If this is a bug, provide a **minimal code snippet** that reproduces it
28-
- Provide **screenshots** where appropriate
29-
- What's the **version** of React Native you're using?
30-
- Does this occur on iOS, Android or both?
31-
- Are you using Mac, Linux or Windows?
17+
- [ ] Provide a **minimal code snippet** / [rnplay](https://rnplay.org/) example that reproduces the bug.
18+
- [ ] Provide **screenshots** where appropriate
19+
- [ ] What's the **version** of React Native you're using?
20+
- [ ] Does this occur on iOS, Android or both?
21+
- [ ] Are you using Mac, Linux or Windows?

PULL_REQUEST_TEMPLATE.md

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,16 @@
1-
Hey there and thanks for submitting a pull request! Please have a look at the following checklist so that others have enough information to review your pull request:
1+
Thanks for submitting a pull request! Please provide enough information so that others can review your pull request:
2+
3+
(You can skip this if you're fixing a typo or adding an app to the Showcase.)
24

35
Explain the **motivation** for making this change. What existing problem does the pull request solve?
46

5-
Example: When saying "Add a function to do X", explain why it is necessary to have a way to do X.
7+
Example: When "Adding a function to do X", explain why it is necessary to have a way to do X.
68

79
**Test plan (required)**
810

9-
Describe exact steps you've done to test that the code works. This means exact commands you ran, screenshots / videos if the pull request changes UI.
11+
Demonstrate the code is solid. Example: The exact commands you ran and their output, screenshots / videos if the pull request changes UI.
1012

11-
Make sure tests pass on Circle CI.
13+
Make sure tests pass on both Travis and Circle CI.
1214

1315
**Code formatting**
1416

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
Use the following tips when responding to GitHub issues.
1+
Here are some tips on how to manage GitHub issues efficiently:
22

33
### An issue is a duplicate of another issue
44
Comment e.g. `@facebook-github-bot duplicate #123`. This will add a comment and close the issue.

docs/PullRequestGuidelines.md

Lines changed: 4 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,4 @@
1+
Here are some tips on how you can help review pull requests:
2+
3+
- Does the PR miss info required in the [Pull request template](https://github.com/facebook/react-native/blob/master/PULL_REQUEST_TEMPLATE.md)? Ask for it and link to the template.
4+
- Does the code style match the [Style guide](https://github.com/facebook/react-native/blob/master/CONTRIBUTING.md#style-guide), especially consistency with the rest of the code? If not, link to the style guide.

0 commit comments

Comments
 (0)