|
| 1 | +# Contributing to public-apis |
| 2 | + |
| 3 | +> While the masses of pull requests and community involvement is appreciated, some pull requests have been specifically |
| 4 | +opened to market company APIs that offer paid solutions. This API list is not a marketing tool, but a tool to help the |
| 5 | +community build applications and use free, public APIs quickly and easily. Pull requests that are identified as marketing |
| 6 | +attempts will not be accepted. |
| 7 | +Thanks for understanding! :) |
| 8 | + |
| 9 | +##Formatting |
| 10 | + |
| 11 | +Current API entry format: |
| 12 | + |
| 13 | +| API | Description | Auth | Link | |
| 14 | +| --- | --- | --- | --- | |
| 15 | +| API Title | Description of API | Does this API require authentication? * | Link to API webpage | |
| 16 | + |
| 17 | +Example entry: |
| 18 | +``` |
| 19 | +| NASA | NASA data, including imagery | No | [Go!](https://api.nasa.gov) | |
| 20 | +``` |
| 21 | +*currently, the only accepted inputs for this field are as follows: |
| 22 | +* OAuth - _the API supports [OAuth][oauth-link]_ |
| 23 | +* apiKey - _the API uses a private key string/token for authentication_ |
| 24 | +* No - _the API requires no authentication to run_ |
| 25 | + |
| 26 | +##Pull Request |
| 27 | + |
| 28 | +After you've created a branch on your fork with your changes, it's time to [make a pull request][pr-link]! |
| 29 | + |
| 30 | +Once you’ve submitted a pull request, the collaborators can review your proposed changes and decide whether or not to incorporate |
| 31 | +(pull in) your changes. |
| 32 | + |
| 33 | +###Pull Request Pro Tips |
| 34 | + |
| 35 | +* [Fork][fork-link] the repository and [clone][clone-link] it locally. |
| 36 | +Connect your local repository to the original `upstream` repository by adding it as a [remote][remote-link]. |
| 37 | +Pull in changes from `upstream` often so that you stay up to date and so when you submit your pull request, |
| 38 | +merge conflicts will be less likely. See more detailed instructions [here][syncing-link]. |
| 39 | +* Create a [branch][branch-link] for your edits. |
| 40 | +* Contribute in the style of the project as outlined above. This makes it easier for the collaborators to merge |
| 41 | +and for others to understand and maintain in the future. |
| 42 | + |
| 43 | +###Open Pull Requests |
| 44 | + |
| 45 | +Once you’ve opened a pull request, a discussion will start around your proposed changes. |
| 46 | +Other contributors and users may chime in, but ultimately the decision is made by the collaborators. |
| 47 | +During the discussion, you may be asked to make some changes to your pull request. |
| 48 | +If so, add more commits to your branch and push them – they will automatically go into the existing pull request! |
| 49 | + |
| 50 | +[clone-link]: <https://help.github.com/articles/cloning-a-repository/> |
| 51 | +[fork-link]: <http://guides.github.com/activities/forking/> |
| 52 | +[branch-link]: <http://guides.github.com/introduction/flow/> |
| 53 | +[syncing-link]: <https://help.github.com/articles/syncing-a-fork> |
| 54 | +[oauth-link]: <https://en.wikipedia.org/wiki/OAuth> |
| 55 | +[pr-link]: <https://help.github.com/articles/creating-a-pull-request/> |
| 56 | +[remote-link]: <https://help.github.com/articles/adding-a-remote/> |
0 commit comments