Thank you for your interest in contributing to the Kubernetes Resource Scanner (KRS) tool! We welcome your contributions and are excited to help make this project better.
Before contributing, please review and adhere to the Code of Conduct. We expect all contributors to follow these guidelines to ensure a positive and inclusive environment.
Our project employs a three-branch workflow to manage the development and release of new features and fixes:
- main: Stable release branch that contains production-ready code.
- pre-release: Staging branch for final testing before merging into main.
- release-v0.x.x: Active development branch where all new changes, bug fixes, and features are made and tested.
To contribute to our project, follow these steps to ensure your changes are properly integrated:
Selecting the Correct Branch
- Always base your work on the latest release-vx.x.x branch. This branch will be named according to the version, for example, release-v0.1.0.
- Ensure you check the branch name in the repository for the most current version branch.
Working on Issues
- Before you start working on an issue, comment on that issue stating that you are taking it on. This helps prevent multiple contributors from working on the same issue simultaneously.
- Include the issue number in your branch name for traceability, e.g., 123-fix-login-bug.
To maintain code quality and orderly management, all contributors must follow this PR process:
Before starting your work, sync your fork with the upstream repository to ensure you have the latest changes from the release-v0.x.x branch:
git checkout release-vx.x.x
git pull origin release-vx.x.x
Create a new branch from the release-vx.x.x branch for your work:
git checkout -b your-branch-name
Make your changes locally and commit them with clear, concise commit messages. Your commits should reference the issue number:
git commit -m "Fix issue #123: resolve login bug"
Push your branch and changes to your fork:
git push -u origin your-branch-name
- Go to the original repository on GitHub and open a pull request from your branch to the release-vx.x.x branch.
- Clearly describe the changes you are proposing in the PR description. Link the PR to any relevant issues.
- All pull requests must undergo review by at least two peers before merging.
- Address any feedback and make required updates to your PR; this may involve additional commits.
- Once your PR is approved by the reviewers, one of the maintainers will merge it into the release-v0.x.x branch.
- The changes will eventually be merged into pre-release and then main as part of our release process.
Notes on Contribution
- Please make sure all tests pass before submitting a PR.
- Adhere to the coding standards and guidelines provided in our repository to ensure consistency and quality.