We highly value and encourage contributions from the community!
Racklet is Apache 2.0 licensed and accepts contributions via GitHub Pull Requests. This document outlines some of the conventions on development workflow, commit message formatting, contact points and other resources to make it easier to get your contribution accepted.
We gratefully welcome improvements to documentation as well as to code.
We are excited about the prospect of you joining our community! The Racklet community abides by the CNCF code of conduct. Here is an excerpt:
As contributors and maintainers of this project, and in the interest of fostering an open and welcoming community, we pledge to respect all people who contribute through reporting issues, posting feature requests, updating documentation, submitting pull requests or patches, and other activities.
In the future, we are also planning to start public, recurring community meetings where anyone can join and participate in the discussion by adding an agenda item to a public meeting notes document.
If you have a feature suggestion, or general question about the project or its roadmap, head over to GitHub Discussions. If you've found a bug, go to GitHub issues and see if there's an open issue matching your description. If not feel free to open a new issue and add short description:
- In case of a bug, be sure to include the steps you performed and the outcomes as detailedly as possible so it's easy for others to reproduce
- If you have a feature suggestion, describe it in moderate detail and include some potential uses you see for the feature. We prioritize the features to be implemented based on their usefulness/popularity. Of course if you want to start contributing yourself, go ahead! We'll be more than happy to review your pull requests.
The maintainers will add the correct labels/milestones to the issue for you.
The process to contribute code to Racklet is generally as follows:
- Go to the project on GitHub and click the
Forkbutton in the top-right corner. This will create your own copy of the repository in your personal account.
- Using standard
cloneyour fork, make your changes and then
pushthem to your repository.
- Go back to GitHub, select
Pull requestsfrom the top bar and click
New pull requestto the right. Select the
compare across forkslink. This will show repositories in addition to branches.
- From the
head repositorydropdown, select your forked repository. If you made a new branch, select it in the
comparedropdown. You should always target
racklet/racklet(or similar repository) and
mainas the base repository and branch.
- With your changes visible, click
Create pull request. Give it a short, descriptive title and write a comment describing your changes. Click
Create pull request.
That's it! Maintainers follow pull requests closely and will add the correct labels and milestones.
After a maintainer's review small changes/improvements could be requested, don't worry, feedback can
be easily addressed by performing the requested changes and doing a
push. Your new
changes will automatically be added to the pull request.
Have fun contributing!