Welcome to the Strangelove contributor guidelines. We are excited to have you here and look forward to your contributions! Contributors are expected to adhere to the guidelines outlined in this document as well as our code of conduct.
There are many ways to contribute, from writing tutorials or blog posts, improving the documentation, submitting bug reports and feature requests, or writing code which can be incorporated into the project itself.
First thing to note is that if you believe you have discovered a security vulnerability DO NOT use the public issue tracker. Please read our security policy for more information on reporting security vulnerabilities.
When creating a bug report, please use the template and include as much detail as possible. At a minimum be sure to include the following:
- What you were trying to do
- How the bug can be reproduced
- What you expected to happen
- What version of the software you were using
Feature requests and other enhancements can be made using the template provided. Please provide as much detail as possible, including the problem you are trying to solve and the solution you would like to see, along with possible alternatives you have considered if applicable. Understanding the use cases and the benefits the new feature or enhancement would bring to users helps the team to prioritize and implement the feature.
Documentation changes are always welcome. If you see a typo, or would like to improve the documentation in any way feel free to open a PR. If you are unsure about the changes you would like to make or if the changes go well beyond addressing simple grammar mistakes or formatting, open an issue to discuss the changes before opening a PR.
When opening new PRs it is advised to open an issue first to discuss the changes you would like to make. This helps to ensure that the changes are in line with the project goals and that the team is aware of the changes being made so that duplicate efforts are not made and everyone's time is used efficiently.
When opening a PR, please ensure that the PR description includes the issue number that the PR is addressing. This helps to ensure that the PR is linked to the issue and that the issue is closed when the PR is merged.
Before opening a PR, please review LICENSE.md and familiarize yourself with its terms. Please be advised that by opening a PR, you are granting Strangelove (or the owner of the relevant repository) a perpetual, worldwide, non-exclusive, no-charge, royalty-free, irrevocable license, in copyright and in patent, with respect to your Contribution and any portion thereof.
Before you start contributing, make sure you have the following prerequisites installed:
To get started, follow these steps:
-
Fork the interchaintest repository to your own GitHub account.
-
Clone your forked repository to your local machine:
git clone https://github.com/<Username>/interchaintest.git
-
Create a new branch on your fork
git checkout -b name/broad-description-of-feature
-
Make your changes and commit them with descriptive commit messages.
-
Test your changes locally with
go test ./...
, or by running the specific test affecting your feature or fix. -
Push your changes to your GitHub forked repository
git push origin name/broad-description-of-feature
-
Create a pull request (PR) against the main branch of the interchaintest repository. If the PR is still a work-in-progress, please mark the PR as draft.