How To Contribute to Kubermatic KubeCarrier

Contributing to Kubermatic KubeCarrier

Kubermatic KubeCarrier is an open-source project for services management across multiple Kubernetes clusters on multiple clouds and across different regions. Thus, contributors in different areas and not limited to project automation, code review, tooling, documentation, testing etc., for the holistic improvement of the Kubermatic KubeCarrier project is highly welcomed. Kubermatic projects are Apache 2.0 licensed and accept contributions via GitHub pull requests from interested contributors. This document outlines some of the conventions on development workflow, contributor’s notes, contributing steps, contact points and other resources to make your contribution to the projects felicitous.

Contributor’s Notes

There are few things to note when contributing to the Kubermatic KubeCarrier project, which are highlighted below:

  • Kubermatic KubeCarrier project is hosted on Github; thus, Github knowledge is one of the essential pre-requisites
  • The KubeCarrier documentation is written in markdown (.md) and located in the docs repository
  • See CONTRIBUTING.md for instructions on the developer certificate of origin that we require
  • Familiarization with Hugo for building static site locally is suggested for documentation contribution
  • Kubernetes knowledge is also recommended
  • The KubeCarrier documentation is currently available only in English
  • We have a simple code of conduct that should be adhered to

Steps in Contributing to Kubermatic KubeCarrier

  • Please familiarise yourself with our Code of Conduct
  • Check the opened issues on our GitHub repo peradventure there might be anyone that will be of interest
  • Fork the repository on GitHub
  • Read the README for build and test instructions

Contribution Workflow

The below outlines show an example of what a contributor’s workflow looks like:

  • Fork the repository on GitHub
  • Create a topic branch from where you want to base your work (usually master)
  • Make commits of logical units.
  • Make sure your commit messages are in the proper format
  • Push your changes to the topic branch in your fork repository
  • Make sure the tests pass and add any new tests as appropriate
  • Submit a pull request to the original repository
  • Assign a reviewer if you wish and wait for the PR to be reviewed
  • If everything works fine, your PR will be merged into the project’s master branch

Congratulations! You have successfully contributed to the Kubermatic KubeCarrier project.

Communication Channels

If you encounter a problem, you can file an issue in the repository on GitHub or talk to us on GitHub, #kubermatic slack channel, and also through our forum link. In case of complex issues, we can set up video meetings for resolution.

Thank you for your contributions!