@@ -8,60 +8,77 @@ Thanks for being willing to contribute!
8
8
## Project setup
9
9
10
10
1 . Fork and clone the repo
11
- 2 . ` $ yarn install ` to install dependencies
12
- 3 . ` $ yarn start validate ` to validate you've got it working
11
+ 2 . ` $ npm install ` to install dependencies
12
+ 3 . ` $ npm start validate ` to validate you've got it working
13
13
4 . Create a branch for your PR
14
14
15
- This project uses [ ` nps ` ] [ nps ] and you can run ` yarn start ` to see what scripts are available.
15
+ This project uses [ ` nps ` ] [ nps ] and you can run ` npm start help ` to see what
16
+ scripts are available.
17
+
18
+ > Tip: Keep your ` master ` branch pointing at the original repository and make
19
+ > pull requests from branches on your fork. To do this, run:
20
+ >
21
+ > ```
22
+ > git remote add upstream https://github.com/prettier/prettier-eslint.git
23
+ > git fetch upstream
24
+ > git branch --set-upstream-to=upstream/master master
25
+ > ```
26
+ >
27
+ > This will add the original repository as a "remote" called "upstream,"
28
+ > Then fetch the git information from that remote, then set your local `master`
29
+ > branch to use the upstream master branch whenever you run `git pull`.
30
+ > Then you can make all of your pull request branches based on this `master`
31
+ > branch. Whenever you want to update your version of `master`, do a regular
32
+ > `git pull`.
16
33
17
34
## Add yourself as a contributor
18
35
19
- This project follows the [ all contributors] [ all-contributors ] specification. To add yourself to the table of
20
- contributors on the README.md, please use the automated script as part of your PR:
36
+ This project follows the [all contributors][all-contributors] specification.
37
+ To add yourself to the table of contributors on the README.md, please use the
38
+ automated script as part of your PR:
21
39
22
40
```console
23
- yarn start contributors.add
41
+ npm start contributors.add
24
42
```
25
43
26
- Follow the prompt. If you've already added yourself to the list and are making a new type of contribution, you can run
27
- it again and select the added contribution type.
44
+ Follow the prompt and commit ` .all-contributorsrc ` and ` README.md ` in the PR.
45
+ If you've already added yourself to the list and are making
46
+ a new type of contribution, you can run it again and select the added
47
+ contribution type.
28
48
29
49
## Committing and Pushing changes
30
50
31
- This project uses [ ` semantic-release ` ] [ semantic-release ] to do automatic releases and generate a changelog based on the
32
- commit history. So we follow [ a convention] [ convention ] for commit messages. Please follow this convention for your
33
- commit messages.
51
+ This project uses [ ` semantic-release ` ] [ semantic-release ] to do automatic
52
+ releases and generate a changelog based on the commit history. So we follow
53
+ [ a convention] [ convention ] for commit messages. You don't have to follow this
54
+ convention if you don't like to. Just know that when we merge your commit, we'll
55
+ probably use "Squash and Merge" so we can change the commit message :)
34
56
35
- You can use ` commitizen ` to help you to follow [ the convention] [ convention ]
36
-
37
- Once you are ready to commit the changes, please use the below commands
38
-
39
- 1 . ` git add <files to be committed> `
40
- 2 . ` $ yarn start commit `
41
-
42
- ... and follow the instruction of the interactive prompt.
57
+ Please make sure to run the tests before you commit your changes. You can run
58
+ ` npm start test.update ` which will update any snapshots that need updating.
59
+ Make sure to include those changes (if they exist) in your commit.
43
60
44
61
### opt into git hooks
45
62
46
- There are git hooks set up with this project that are automatically installed when you install dependencies. They're
47
- really handy, but are turned off by default (so as to not hinder new contributors). You can opt into these by creating
48
- a file called ` .opt-in ` at the root of the project and putting this inside:
63
+ There are git hooks set up with this project that are automatically installed
64
+ when you install dependencies. They're really handy, but are turned off by
65
+ default (so as to not hinder new contributors). You can opt into these by
66
+ creating a file called ` .opt-in ` at the root of the project and putting this
67
+ inside:
49
68
50
69
```
51
- commit-msg
52
70
pre-commit
53
71
```
54
72
55
73
## Help needed
56
74
57
- Please checkout the [ ROADMAP.md] [ ROADMAP ] and raise an issue to discuss
58
- any of the items in the want to do or might do list.
75
+ Please checkout the [ the open issues] [ issues ]
59
76
60
77
Also, please watch the repo and respond to questions/bug reports/feature requests! Thanks!
61
78
62
79
[ egghead ] : https://egghead.io/series/how-to-contribute-to-an-open-source-project-on-github
63
80
[ semantic-release ] : https://npmjs.com/package/semantic-release
64
81
[ convention ] : https://github.com/conventional-changelog/conventional-changelog-angular/blob/ed32559941719a130bb0327f886d6a32a8cbc2ba/convention.md
65
82
[ all-contributors ] : https://github.com/kentcdodds/all-contributors
66
- [ ROADMAP ] : ./other/ROADMAP.md
67
- [ nps ] : https://npmjs .com/package /nps
83
+ [ issues ] : https://github.com/prettier/prettier-eslint/issues
84
+ [ nps ] : https://github .com/kentcdodds /nps
0 commit comments