We can be reached via creating an issue or Github Discussions if it is available for this repository.
DEPRECATION NOTICE : We also have a Spectrum Chat, however this is deprecated and will become read-only on 2021, August 10th.
See the LICENSE file for our project's licensing. We will ask you to confirm the licensing of your contribution.
We may ask you to sign a Contributor License Agreement (CLA) for larger changes.
Issues are very valuable to this project.
- Ideas are a valuable source of contributions others can make
- Problems show where this project is lacking
- With a question you show where contributors can improve the user experience and/or documentation
Thank you for creating them.
Pull requests are, a great way to get your ideas into this repository.
When deciding if I merge in a pull request I look at the following things:
You should be clear which problem you're trying to solve with your contribution.
For example:
Add link to code of conduct in README.md
Doesn't tell me anything about why you're doing that
Add link to code of conduct in README.md because users don't always look in the CONTRIBUTING.md
Tells me the problem that you have found, and the pull request shows me the action you have taken to solve it.
- There are no spelling mistakes
- It reads well
- For english language contributions: Has a good score on Grammarly or Hemingway App
- For code contributions: It should minimally pass the automated code quality checks such as linting and tests, as well was having new tests of its own.
The aim of this repository can be found in README.md
This repository has a code of conduct, This repository has a code of conduct, I will remove things that do not respect it.
Fork using GitHub Desktop:
- Getting started with GitHub Desktop will guide you through setting up Desktop.
- Once Desktop is set up, you can use it to fork the repo!
Fork using the command line:
- Fork the repo so that you can make your changes without affecting the original project until you're ready to merge them.
Fork with GitHub Codespaces (if available for this repository):
- Fork, edit, and preview using GitHub Codespaces without having to install and run the project locally.
Make your changes to the file(s) you'd like to update.
- Are you making changes to the application code? See README.md for more information on how to run this project locally.
- Are you contributing to documentation in this repository? We use GitHub Markdown.
When you're done making changes and you'd like to propose them for review, use the pull request button to open your PR (pull request).
- Once you submit your PR, core contributors from this repository will review it with you. The first thing you're going to want to do is a self review.
- After that, we may have questions, check back on your PR to keep up with the conversation.
- Did you have an issue, like a merge conflict? Check out our git tutorial on how to resolve merge conflicts and other issues.
We aim to review every single PR. The purpose of reviews is to create the best content we can for people who use and/or build on our product.
💛 Reviews are always respectful, acknowledging that everyone did the best possible job with the knowledge they had at the time.
💛 Reviews discuss content, not the person who created it.
💛 Reviews are constructive and start conversation around feedback.
You should always review your own PR first.
For content changes, make sure that you:
- Confirm that the changes address every part of the content design plan from your issue (if there are differences, explain them).
- Review the content for technical accuracy.
- Copy-edit the changes for grammar, spelling.
- Check that all of your changes render correctly in the deploy preview.
- If there are any failing checks in your PR, troubleshoot them until they're all passing.
We may ask for changes to be made before a PR can be merged, either using suggested changes or pull request comments. You can apply suggested changes directly through the UI. You can make any other changes in your fork, then commit them to your branch.
As you update your PR and apply changes, mark each conversation as resolved.
This CONTRIBUTING.md was written with much reference to materials from https://gist.github.com/PurpleBooth/b24679402957c63ec426 and https://github.com/github/docs/blob/main/CONTRIBUTING.md