|
| 1 | +# Contributing |
| 2 | + |
| 3 | +Thanks for being willing to contribute! |
| 4 | + |
| 5 | +**Working on your first Pull Request?** You can learn how from this _free_ |
| 6 | +series [How to Contribute to an Open Source Project on GitHub][egghead] |
| 7 | + |
| 8 | +## Project setup |
| 9 | + |
| 10 | +1. Fork and clone the repo |
| 11 | +2. Run `yarn install` to install dependencies |
| 12 | +3. Create a branch for your PR with `git checkout -b pr/your-branch-name` |
| 13 | + |
| 14 | +> Tip: Keep your `main` branch pointing at the original repository and make pull |
| 15 | +> requests from branches on your fork. To do this, run: |
| 16 | +> |
| 17 | +> ``` |
| 18 | +> git remote add upstream https://github.com/thedaviddias/gatsby-source-notion-article.git |
| 19 | +> git fetch upstream |
| 20 | +> git branch --set-upstream-to=upstream/main main |
| 21 | +> ``` |
| 22 | +> |
| 23 | +> This will add the original repository as a "remote" called "upstream," Then |
| 24 | +> fetch the git information from that remote, then set your local `main` branch |
| 25 | +> to use the upstream main branch whenever you run `git pull`. Then you can make |
| 26 | +> all of your pull request branches based on this `main` branch. Whenever you |
| 27 | +> want to update your version of `main`, do a regular `git pull`. |
| 28 | +
|
| 29 | +## Committing and Pushing changes |
| 30 | +
|
| 31 | +Please make sure to run the tests before you commit your changes. You can run |
| 32 | +`yarn run test` to run Jest or `yarn run test:watch` on watch mode. Make |
| 33 | +sure to include those changes (if they exist) in your commit. |
| 34 | +
|
| 35 | +## Help needed |
| 36 | +
|
| 37 | +Please checkout the [the open issues][issues] |
| 38 | +
|
| 39 | +Also, please watch the repo and respond to questions/bug reports/feature |
| 40 | +requests! Thanks! |
| 41 | +
|
| 42 | +[egghead]: https://app.egghead.io/series/how-to-contribute-to-an-open-source-project-on-github |
| 43 | +[all-contributors]: https://github.com/all-contributors/all-contributors |
| 44 | +[issues]: https://github.com/thedaviddias/gatsby-source-notion-article/issues |
0 commit comments