Welcome to the OCM community!
Thank you for taking the time to contribute to OCM.
By contributing to this project you agree to the Developer Certificate of Origin (DCO). This document was created by the Linux Kernel community and is a simple statement that you, as a contributor, have the legal right to make the contribution.
Signed-off-by: Jane Doe <email@example.com>
user.email are configured in your Git config, you can sign your commit automatically with
git commit -s.
Before opening a new issue or submitting a Pull Request, make sure to search through the docs, open and closed issues, open and merged Pull Requests, and the Discussions board to check whether your question has been raised or answered already.
If you wish to propose or discuss a more involved feature or change to any of the OCM projects, you could start a new thread in the
ocm Discussion Board. For example, this could be helpful if you wish to vet an idea before writing a feature request. It is a space to discuss in public with maintainers, contributors, users, and other interested parties. After reaching some form of consensus, the proposed changes can go through the pull request process where implementation details are reviewed, approved, or rejected by maintainers.
Ways to Contribute
We welcome all types of contributions, including:
- New features
- Bug reports/fixes
- Reviewing/updating documentation
- Backfilling tests
- Joining discussions
- Web design
- Release management
- Board discussions
For more involved feature or enhancement requests, please see the section on how to submit an ADR.
You may find it helpful to start a new thread in the
ocm Discussion Board for questions, help requests, feature requests, or any other type of discussion about OCM. A maintaine will reach out to you as soon as possible.
Find an Issue
Take a look at the OCM issues to find out more about what is currently in the works and what is planned. If you find something that you are interested in picking up, please leave a comment and wait for a maintainer to give you the green light to claim it and start working on it.
If you would like to contribute but are unsure about where to start, feel free to let the maintainers know through the
ocm Discussion Board and someone will reach out to you.
Each project has its own setup for local development.
Submitting Pull Requests
Ready to contribute? Read and follow the sections below to get your contribution to the finish line.
Pull Request Checklist
- Fork the repository, push your changes to a branch on your fork, then open a PR from that branch to the source repository’s
- Add as much information as possible in your PR description about what changed, why, as well as steps to test these changes.
- Sign your commits.
- Ensure that the branch is up to date with
- Write a neat title that is ready to be added to future release notes.
- Update documentation (either in the docs or README) that cover your changes.
- Add unit tests and integration tests to cover your changes.
- Ensure that the linter and all unit and integration tests are successful.
- [Bonus] Backfill tests/documentation to make the world a better place.
Pull Request Process
- Create PR. Please refer to the Pull Request Checklist before marking a PR as ready to be reviewed.
- Triage. A maintainer will triage the Pull Request by adding the appropriate label for the issue.
- Assign reviews. A maintainer will be assigned to review the changes in the Pull Request.
- Review/Discussion. One or more maintainer will review the Pull Request. Checkout the style guidelines section for some things reviewers will look for.
- Address comments by answering questions or changing code.
- Approve/Merge. A review should be approved by at least two other maintainers. If the PR was opened by a community contributor, they should wait for a maintainer to merge the Pull Request.
For Go standards, it is recommended to take a look at the Go Code Review Comments and the Formatting and style section of Peter Bourgon’s Go: Best Practices for Production Environments.–