We love contributions from everyone, regardless of your skill level! If you need any help getting started contributing to an open source project, don't hesistate to contact us at [email protected]!
This project uses Semantic Versioning and abides by the Contributor Covenant 1.4. If you're not familiar with these, please take a moment to skim through them, just to get an idea of the guidelines we follow.
We reserve the right to refuse your contribution if you do not follow the above terms.
If you need any assistance, either create a new issue or join our Discord server.
- Fork the repository.
- Switch to the develop branch. If you work in the master branch, we will reject your pull request!
- If you haven't already, run
npm install
. Make sure thatnode_modules
is not tracked by Git.
- Follow the Google JavaScript style guide. This isn't strictly enforced, but we may ask you to reformat your code if deemed necessary. (We're also guilty of illegal formatting. If you catch something that is formatted incorrectly, please create an issue explaining the problem.
- Document your code using the JSDoc format. Again, if you find something documented improperly, please create an issue.
- If you need extra dependencies, import them at the highest level possible. (From high to low: Current component -> Current module -> Any parent module(s) -> app.module.ts)
If you feel that you absolutely need to import a dependency into
app.module.ts
, contact us first. - When committing, make a descriptive but concise message. We don't expect essays, but
add stuff
just seems a bit inadequate, don't you think?
- Before submitting, make sure that all of your dependencies match
package.json
and the production build throws no errors (neither compilation nor runtime). - Create a pull request to the develop branch.
- Write a good description, and don't forget to add a label and milestone!
- Make sure that the TravisCI checks pass on your PR. If not, go back to step 1.
- Wait for your contribution to be approved! We may contact you with any questions or concerns.
Remember to update the API Documentation for any new methods, classes, or behaviors!