Project Steering

This page describes how project-wide topics in Gardener are proposed, discussed, and decided via Gardener Enhancement Proposals (GEPs) in the context of the Gardener Technical Steering Committee (TSC).

GEPs are the canonical mechanism for proposals that meet the criteria for steering-level discussion. They live in the dedicated repository gardener/enhancements.

Each proposal discussed in a steering meeting is represented by a Gardener Enhancement Proposal (GEP). A GEP provides sufficient context, motivation, and a concrete ask or decision request to facilitate informed and effective discussion during the steering meeting.

🧑‍💻 Technical Steering

Technical Steering provides architectural and technical direction for major product increments. Technical documents can be submitted to the Technical Steering Committee as Gardener Enhancement Proposals (GEPs). The document should outline the proposed solution, with a particular focus on APIs and interfaces, while also covering other relevant aspects, but no full implementation is expected (or desired) at this stage.

Before submitting a GEP, it is recommended to first circulate your idea to gauge community interest — for example, via Slack or community meetings. This helps ensure the proposal is well-motivated and increases the likelihood of a productive steering discussion.

So, Gardener's Technical Steering discusses topics when a design document has been crafted. It focuses on both the 'Whether'/'Why' and the 'How' question.

The committee will schedule a Technical Steering meeting where the proposer presents the GEP. Committee members and interested contributors will challenge and discuss the idea. This meeting will be recorded.

A decision on how to proceed with the proposal, including any recommended improvements, will be made within the same meeting. The decision and any required changes will be documented in the GEP.

Why Do We Need It?

Technical Steering ensures that major technical changes align with Gardener's architectural principles and long-term sustainability. It prevents fragmentation and promotes consistency in the project's evolution. The process helps ensure that major technical investments deliver value to both Gardener's users and maintainers.

Who is on The Technical Steering Committee?

The committee is elected by the project's active code owners and contributors and consists of a small number of members (at least three). Currently, the committee members are:

• Johannes Scheerer (Email and Slack)
• Rafael Franzke (Email and Slack)
• Tim Ebert (Email and Slack)
• Vedran Lerenc (Email and Slack)

Key Considerations for Topics

A topic qualifies for Technical Steering if it:

• Requires significant development effort, OR
• Has relevant cross-team impact, OR
• Impacts Gardener's users or ecosystem significantly, OR
• Introduces high technical or operational risk

🧭 How to Propose a Topic

If you'd like to bring a topic to the steering meeting, follow these steps:

1. Create a tracking issue to reserve a GEP number: https://github.com/gardener/enhancements/issues/new?template=enhancement.md
2. Create a proposal document using the official template in gardener/enhancements.
3. Open a Pull Request against the gardener/enhancements repository.
4. The steering committee will start reviewing your PR - please react on their feedback!
5. Once the initial PR reviews have been completed, a member of the steering committee will coordinate scheduling a meeting to discuss the GEP.

💡 Keep your proposal concise (2–5 pages). The goal is to clearly motivate your idea and define what decision or feedback you need.

📆 What Happens After Opening a PR?

Once your PR is open:

• A member of the steering committee will reach out and coordinate the next steps.
• The proposal is first reviewed asynchronously by the committee via the Pull Request:
  • Steering committee members review the document and leave questions or comments directly in the PR review.
  • The goal of this phase is to clarify open questions and address smaller issues before the meeting.
• Once feedback from a majority of the committee (typically 3 out of 4 members) has been provided, a steering meeting is scheduled.
  • A TSC meeting is usually scheduled about two weeks later to allow for review ping-pong and for incorporating feedback into the document.
• The meeting will be announced to the community via our #gardener Slack channel and in the public meeting agenda (e.g., here).
• Based on the outcome of the meeting, the proposal in the GEP PR may need to be adjusted, refined, or extended. In this case, the PR remains open and meeting feedback is addressed asynchronously. Depending on the outcome, an additional steering meeting may be scheduled. Once all steering committee members are satisfied, the GEP PR is merged, which signals a clear go for the next steps (typically implementation work).

🗣️ Participation

• Those who wish to actively challenge or discuss the proposal can request an invitation from any committee member.
• Others are encouraged to watch the recording instead of attending live.

📑 Meeting Process

• Attendees are expected to have read the proposal in advance and come prepared.
• The meeting will be scheduled for 1h and is split into 25-25-10 minute blocks:
  • Attendees then have up to 25 minutes time to ask clarifying questions.
  • The next 25 minutes are reserved to provide feedback, possibly challenge the document, and generally for an active discussion.
  • The last 10 minutes are reserved to take a decision.
• The session is recorded and shared with the community for transparency.

👨‍⚖️ Decision Process

• A go/no-go decision is made during the meeting, along with recommended improvements if needed.
• The final decision and any necessary changes are documented on this community page.

🗒️ Where Are Decisions and Meeting Minutes Published?

A link to the recording, the final decisions and (optionally) meeting minutes will be tracked directly in the top of the proposal documents.