👍 First off, thanks for taking the time to contribute! 👍
We're excited to hear and learn from you. Your experiences will benefit others who read and use these guides. We've put together the following guidelines to help you figure out where you can best be helpful. These are mostly guidelines, not rules. Use your best judgment, and feel free to propose changes to this document in a pull request.
- Types of contributions we're looking for
- How Can I Contribute?
- Setting up your environment
- Pull requests
- License
There are many ways you can directly contribute to the guides (in descending order of need):
- Reporting a bug
- Discussing the current state of the code
- Submitting a fix
- suggesting enhancements
Report bugs using Github's issues
We use GitHub issues to track public bugs. Report a bug by opening a new issue; it's that easy! Write bug reports with detail, background, and sample code.
Great Bug Reports tend to have:
- A quick summary and/or background
- Steps to reproduce
- Be specific!
- Give sample code if you can.
- What you expected would happen
- What actually happens
- Notes (possibly including why you think this might be happening, or stuff you tried that didn't work)
How Do I Submit A Enhancement Suggestion?
Enhancement suggestions are tracked as GitHub issues. Create an issue on this repository and provide the following information:
- Use a clear and descriptive title for the issue to identify the suggestion.
- Provide a step-by-step description of the suggested enhancement in as many details as possible.
- Describe the current behavior and explain which behavior you expected to see instead** and why.
Clone the repository with:
git clone git@github.com:expandorg/frontend-utils.git
yarn run tests
We Use Github Flow, So All Code Changes Happen Through Pull Requests Pull requests are the best way to propose changes to the codebase (we use Github Flow). We actively welcome your pull requests:
- Fork the repo and create your branch from
master
. - If you've added code that should be tested, add tests.
- If you've changed APIs, update the documentation.
- Ensure the test suite passes.
- Make sure your code lints.
- Issue that pull request!
By contributing, you agree that your contributions will be licensed under its MLP-2 License.
Thanks! ❤️
Expand.org Team