How to Contribute
If you're wondering how to contribute to open source project and this is your first time, you're at the right place.
- First, you'll want to fork the repository to your own account. You can do that by clicking the fork button in the top right of our repository.
Clone the forked respository to your local machine. Click the green Code button, and copy the URL. Open up a terminal on your local computer to where you want the repository to be and enter:
git clone PASTED_URL_HERE
It should look like this:
git clone https://github.com/your-username/peterportal-public-api.git
Navigate to the respository by entering
Add the project repository as the "upstream" remote. You can do that by entering this command:
git remote add upstream https://github.com/icssc/peterportal-public-api.git
git remote -vto check that you have 2 remotes. An origin that points to your forked repository on your account, and upstream that points to this project repository.
Update your repo with the latest changes by running:
git pull upstream master
Create a new branch that you will work on. You will usually name the branch something related to the issue you are solving (i.e.
git checkout -b BRANCH_NAME
Make some changes and commits. Once you're done push your changes to your fork.
git push origin BRANCH_NAME
Once you've made all the changes you need, you can create a pull request. Open your forked repository and switch to the branch you were working on. Click the New Pull Request button.
Fill out the Pull Request template including details about your changes. Once you're done, create the pull request. Eventually a project maintainer will review the PR. New changes might be requested, in which case you can make new commits for them. Once the pull request is approved, it will be merged, and your changes will be added to the project's master branch.
You have officially made a contribution to our project. Thank you! Once the changes go through, you can delete the old branch, and update your local respository and push the update to your forked respository.
git pull upstream master git push origin master
Now, you are ready to make even more contributions!
|/cache||Houses the local data cache|
|/db||Houses grades data cache|
|/docs||Markdown files for documentation|
|/docs-site||Built HTML files for documentation|
|/graphql||GraphQL schema files|
|/helpers||Helper methods for both APIs|
|/public||Assets to be accessible via Public URL|
|/rest||Contains the routes of our REST API|
|/tests||Jest test files|
|/utils||Utilities for data changes|
|app.js||Configuration for Express|
|mkdocs.yml||Configuration for MkDocs|
|server.js||Starting server locally for development|