This is a living guide that defines a development process for yearn.finance protocol.
We want to make contributing to this project as easy and transparent as possible, whether it's:
- Bug report.
- Current state of the code discussion.
- Fix submission.
- Feature proposal.
- Maintainer application.
We use Github to host code, to track issues and feature requests, as well as accept pull requests.
Pull requests are the best way to propose changes to the codebase (we use Github flow). We welcome your pull requests:
- Fork the repo and create your branch from
master
. - If you've added code that should be tested, add tests or ensure it doesn't break current tests.
- If you've changed something impacting current docs, please update the documentation.
- Ensure the test suite passes (if applicable).
- Ensure your code follows formatting rules.
- Issue that pull request!
The master
branch has the up to date changes of the codebase with working code. Releases should be tracked via git tags to link a specific commit to a deployment for history and documentation purposes.
Repository uses GH actions to setup CI for test harness. Be sure to setup any secret or env variable needed for your GH actions to work.
We use GitHub issues to track public bugs. Report a bug by opening a new issue; it's that easy!
Before adding a new issue, please check that your issue is not already identified or hasn't been handled by searching the active/closed issues.
Great Bug Reports tend to have:
- A clear and concise summary of an issue.
- Steps to reproduce a bug.
- What is expected to happen.
- What actually happens.
- Notes.
- Setup prettier and solium linters into your local coding environment.
- Check that your changes adhere to the linting rules before pushing by running
yarn lint:check
andyarn lint:fix
. - Merging may be blocked if a PR does not follow the coding style guidelines.
By contributing, you agree that your contributions will be licensed under its APGL License.
TBD