First, thank you for contributing to VRL! The goal of this document is to provide everything you need to get started.
- For large PRs, breaking changes or if you just want feedback from us and the community, open a new issue. Please take a look at existing issues to avoid duplicates.
- Fork the VRL repository in your own GitHub account (only applicable to outside contributors).
- Create a new Git branch.
- Make your changes.
- Add and/or update tests to cover your changes.
- Run
./scripts/checks.sh
to run tests and other checks. These checks are also run by the CI. - Submit the branch as a pull request to the repo. A team member should comment and/or review your pull request.
- Add a changelog fragment (requires the PR number) to describe your changes which will be included in the release changelog. See the README.md for details.
- It is normal to have multiple review iterations on a PR. To enable incremental reviews, please try to avoid force pushing if possible.
- When a rebase is needed, try
git merge origin main
followed bygit push
.
- When a rebase is needed, try