Skip to content

Latest commit

 

History

History
79 lines (55 loc) · 4.27 KB

CONTRIBUTING.md

File metadata and controls

79 lines (55 loc) · 4.27 KB
Raw

Contributing

You can contribute by:

  • Raising any issues you find using Strimzi
  • Fixing issues by opening Pull Requests
  • Improving documentation
  • Talking about Strimzi

All bugs, tasks or enhancements are tracked as GitHub issues. Issues which might be a good start for new contributors are marked with the “good-start” label.

The development guide describes how to quickly get setup to build Strimzi from source. It also goes into more detail of various ways you can build Strimzi and how to test your changes before submitting a patch or opening a pull request.

The release checklist describes the steps that need to be completed for a new version release.

The documentation contributor guide describes how to contribute to Strimzi documentation.

If you want to get in touch with us first before contributing, you can use:

Developer Certificate Of Origin

The Developer Certificate of Origin (DCO) is a lightweight way for contributors to certify that they wrote or otherwise have the right to submit the code they are contributing to the project.

Contributors to the Strimzi project sign-off that they adhere to these requirements by adding a Signed-off-by line to commit messages.

This is my commit message

Signed-off-by: John Doe <[email protected]>

Git even has a -s command line option to append this automatically to your commit message:

git commit -s -m 'This is my commit message'

If you have already made a commit and forgot to include the sign-off, you can amend your last commit to add the sign-off with the following command, which can then be force pushed.

git commit --amend -s

How to become a maintainer

The governance of the project is defined in the GOVERNANCE.md file in the Strimzi Github repository, but in summary certain members of the community are the "maintainers" who decide the direction of the project. New maintainers can be elected by a ⅔ majority vote of the existing maintainers.

So as to be transparent and to ensure that all potential maintainers are judged fairly and consistently the following criteria should be taken into account in electing new maintainers:

Criteria

  • Sustained contributions over at least 3 months ideally including non-trivial PRs.
  • An area of developing expertise. This includes the HTTP Bridge and Oauth components. The candidate does not have to be the go-to expert, but they should have a more than superficial understanding of at least one area. For example:
    • A particular operator
    • Some Kubernetes concern (CRDs, API, JSON Schema, and so on)
    • Some associated bit of Kafka technology in which the project has a strategic interest (Cruise Control, for example)
    • System tests
    • Documentation
  • Reviewing other contributors' PRs (not just for trivial errors, such as typos, but also guiding contributors on "big picture" aspects such as the future direction of the project).
  • Contributing to different aspects of the project and community. For example it’s not enough to just implement features. We should also consider:
    • Bug reporting, triage and fixing
    • Addressing technical debt (in code, testing and documentation).
    • Documentation (both content and structure).
    • Helping users, for example on GitHub, the mailing list, Slack, Stack Overflow, and so on.
    • Promotion of Strimzi, for example by blogging, speaking at conferences, and so on.
  • An understanding of the overall architecture/structure of the codebase.
  • Knowing when to ask for help or seek consensus (being a maintainer is not a licence to merge "at will" whatever you chose).
  • An indication of being committed to the long term success of the project.