Thank you for your interest in contributing to Rodent! To ensure a smooth and effective review process, please follow these guidelines when submitting a pull request (PR).
-
Fork the Repository: Create your own fork of the Rodent repository on GitHub.
-
Clone Your Fork:
git clone https://github.com/stratastor/rodent.git cd rodent
-
Add Upstream Remote: Add the original repository as a remote named
upstream
.git remote add upstream https://github.com/stratastor/rodent.git
-
Fetch Upstream Changes: Fetch the latest changes from the upstream repository.
git fetch upstream
-
Rebase Your Fork: Rebase your fork's main branch with the upstream main branch.
git checkout main git pull --rebase upstream main
-
Create a Branch: Create a new branch for your feature or bugfix.
git checkout -b feature/kickarse-api-module
-
Make Your Changes: Write your code and tests.
-
Run Tests: Ensure all tests pass before committing.
ubuntu@staging:~/rodent$ cd pkg/zfs && sudo go test -v ./...
-
Commit Your Changes: Commit your changes with a descriptive message.
git add . git commit -a
-
Push to Your Fork: Push your branch to your fork on GitHub.
git push origin feature/kickarse-api-module
-
Create a Pull Request: Go to the original Rodent repository on GitHub and create a pull request from your fork.
Before submitting your pull request, please ensure the following:
- Descriptive Title and Description: Provide a clear and concise title and description for your pull request. Explain the purpose and motivation behind your changes.
- Reference Issues: If your pull request addresses any open issues, reference them in the description using the format
Fixes #issue_number
orUpdates/Related to #issue_number
. - Code Style: Ensure your code adheres to the project's coding standards and style guidelines.
- Tests: Add tests for your changes and ensure all existing tests pass.
- Documentation: Update any relevant documentation to reflect your changes.
- Review Your Changes: Double-check your code for any errors or improvements before submitting.
- Be Responsive: Be available to respond to any questions or feedback from the reviewers.
- Make Necessary Changes: If requested, make the necessary changes and update your pull request.
- Keep Commits Clean: Squash or rebase your commits if necessary to keep the commit history clean and meaningful.
Thank you for contributing to Rodent! Your efforts are greatly appreciated.