Skip to content

Commit

Permalink
Document backporting rules for Go lang minor versions for images
Browse files Browse the repository at this point in the history
This PR also rewrites the Backporting section a bit and puts on clear identifiers for backporting rules.
Signed-off-by: Kashif Khan <kashif.khan@est.tech>
  • Loading branch information
kashifest committed Jun 17, 2024
1 parent c52d708 commit 35b073e
Showing 1 changed file with 32 additions and 3 deletions.
35 changes: 32 additions & 3 deletions CONTRIBUTING.md
Original file line number Diff line number Diff line change
Expand Up @@ -92,9 +92,38 @@ provide any backward compatible guarantees.

#### Backporting

We only accept backports of critical bugs, security issues, or bugs without easy
workarounds, any backport MUST not be breaking for either API or behavioral
changes. We generally do not accept PRs against older release branches.
We generally do not accept PRs directly against release branches, while we might
accept backports of fixes/changes already merged into the main branch.

We generally allow backports of following changes to all supported branches:

- Critical bug fixes, security issue fixes, or fixes for bugs without easy
workarounds.
- Dependency bumps for CVE (usually limited to CVE resolution; backports of
non-CVE related version bumps are considered exceptions to be evaluated case by
case)
- Changes required to support new Kubernetes patch versions, when possible.
- Changes to use the latest Go patch version to build controller images.
- Changes to bump the Go minor version used to build controller images, if the
Go minor version of a supported branch goes out of support (e.g. to pick up
bug and CVE fixes). This has no impact on users importing Cluster API Provider
Metal3 as we won't modify the version in go.mod and the version in the Makefile
does not affect them.

We generally allow backports of following changes only to the latest supported
branch:

- Improvements to existing docs
- Improvements to the test framework

Like any other activity in the project, backporting a fix/change is a
community-driven effort and requires that someone volunteers to own the task.
In most cases, the cherry-pick bot can (and should) be used to automate
opening a cherry-pick PR.

We generally do not accept backports to CAPM3 release branches that are out of
support. Check the [Version support](https://github.com/metal3-io/metal3-docs/blob/main/docs/user-guide/src/version_support.md)
guide for reference.

## Branches

Expand Down

0 comments on commit 35b073e

Please sign in to comment.