Getting Started with Contributing

Contribute / Start Here

Contributor setup

Prepare a workstation, create a first branch, and run the initial local checks.

Set up your environmentOpen testing strategy

Use this page to

• prepare the required local tools for repo-managed commands
• understand the first commands maintainers expect you to run on a clean clone
• see the basic contribution path before diving into standards or CI details
• find the right next page once the environment itself is working

Verify

PR-equivalent local gate

bash

make bootstrap
make doctor
make ci-core

Use this as the baseline local proof for a new branch or workstation setup.

Core path

1. 01

   Set up your environment

   Install the required tools, use the repo-managed bootstrap flow, and verify that your local environment is actually healthy.

   Open
2. 02

   Learn the coding rules

   Read the project conventions, code standards, and generated-artifact rules before reshaping code or manifests.

   Open
3. 03

   Understand the testing stack

   Know which layers to run locally and what CI is going to enforce for the branch.

   Open
4. 04

   Open a clean branch

   Use the commit and change-management rules the project expects once your local setup is stable.

   Open

Decision matrix

Contribution lanes

Contribution lanes.

Type	What it usually changes	Read this next
Code changes	Controller logic, APIs, adapters, reconciliation behavior, tests, or generated assets.	Open the coding standards and testing strategy.
Documentation changes	User guides, contributor docs, IA work, examples, or style fixes.	Open the documentation style guide and contributor standards.
Maintainer work	Release flow, CI changes, distribution policy, or supply-chain controls.	Open Validate & Ship and Project Governance.

After setup

Set up your environmentUse the detailed setup page for tools, versions, and local cluster guidance.Coding standardsRead the project rules for code and docs changes.Testing strategyMap your change to the right unit, integration, E2E, or manual validation layer.