How to Contribute

Flagger 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.

Certificate of Origin

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.

We require all commits to be signed. By signing off with your signature, you certify that you wrote the patch or otherwise have the right to contribute the material by the rules of the DCO:

Signed-off-by: Jane Doe <jane.doe@example.com>

The signature must contain your real name (sorry, no pseudonyms or anonymous contributions) If your user.name and user.email are configured in your Git config, you can sign your commit automatically with git commit -s.

Communications

The project uses Slack: To join the conversation, simply join the CNCF Slack workspace and use the #flagger channel.

The developers use a mailing list to discuss development as well. Simply subscribe to flux-dev on cncf.io to join the conversation (this will also add an invitation to your Google calendar for our Flux meeting).

Getting Started

Fork the repository on GitHub
If you want to contribute as a developer, read Flagger Development Guide
If you have questions, concerns, get stuck or need a hand, let us know on the Slack channel. We are happy to help and look forward to having you part of the team. No matter in which capacity.
Play with the project, submit bugs, submit pull requests!

Contribution workflow

This is a rough outline of how to prepare a contribution:

Create a topic branch from where you want to base your work (usually branched from master).
Make commits of logical units.
Make sure your commit messages are in the proper format (see below).
Push your changes to a topic branch in your fork of the repository.
If you changed code:
- add automated tests to cover your changes
Submit a pull request to the original repository.

Acceptance policy

These things will make a PR more likely to be accepted:

a well-described requirement
new code and tests follow the conventions in old code and tests
a good commit message (see below)
All code must abide Go Code Review Comments
Names should abide What's in a name
Code must build on both Linux and Darwin, via plain go build
Code should have appropriate test coverage and tests should be written to work with go test

In general, we will merge a PR once one maintainer has endorsed it. For substantial changes, more people may become involved, and you might get asked to resubmit the PR or divide the changes into more than one PR.

Format of the Commit Message

For Flagger we prefer the following rules for good commit messages:

Limit the subject to 50 characters and write as the continuation of the sentence "If applied, this commit will ..."
Explain what and why in the body, if more than a trivial change; wrap it at 72 characters.

The following article has some more helpful advice on documenting your work.

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

CONTRIBUTING.md

CONTRIBUTING.md

How to Contribute

Certificate of Origin

Files

CONTRIBUTING.md

Latest commit

History

CONTRIBUTING.md

File metadata and controls

How to Contribute

Certificate of Origin