Skip to content

docs: add multi-organization maintainership plan#12

Merged
mohit-nagaraj merged 1 commit intomainfrom
docs/multi-org-plan
Mar 24, 2026
Merged

docs: add multi-organization maintainership plan#12
mohit-nagaraj merged 1 commit intomainfrom
docs/multi-org-plan

Conversation

@mohit-nagaraj
Copy link
Copy Markdown
Member

Summary

  • Adds MULTI_ORG_MAINTAINERSHIP.md with three-phase strategy
  • Phase 1: Lower barriers (good-first-issues, fast reviews, contributor docs)
  • Phase 2: Build visibility (talks, blogs, CNCF TAG engagement, partnerships)
  • Phase 3: Cultivate maintainers (mentorship, component ownership, LFX Mentorship)
  • Includes measurable targets and risk mitigations

Related Issue

Closes #5

Test plan

  • Strategy is actionable and realistic
  • Metrics are measurable

Three-phase strategy to grow external maintainership:
1. Lower barriers (good-first-issues, docs, fast reviews)
2. Build visibility (talks, blogs, CNCF TAG engagement)
3. Cultivate maintainers (mentorship, shared ownership, LFX)

Includes metrics and risk mitigations.

Closes #5

Signed-off-by: Mohit Nagaraj <mohitnagaraj20@gmail.com>
@mohit-nagaraj mohit-nagaraj added the must-fix-for-cncf Required for CNCF Sandbox submission label Mar 24, 2026
@mohit-nagaraj mohit-nagaraj merged commit 3a23c22 into main Mar 24, 2026
1 check passed
@mohit-nagaraj mohit-nagaraj deleted the docs/multi-org-plan branch March 24, 2026 06:24
@gemini-code-assist
Copy link
Copy Markdown

Summary of Changes

Hello, I'm Gemini Code Assist1! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request introduces a foundational document outlining a strategic, phased plan to expand KubeOrch's maintainer base beyond its initial founding team. The plan is designed to attract, engage, and cultivate external maintainers, which is a critical step for the project's CNCF sandbox acceptance and long-term sustainability. It provides a clear roadmap with actionable steps, measurable targets, and proactive risk management.

Highlights

  • New Document Added: Introduced MULTI_ORG_MAINTAINERSHIP.md which outlines a comprehensive three-phase strategy for achieving multi-organization maintainership for the KubeOrch project.
  • Phase 1: Lowering Barriers: Detailed strategies for attracting new contributors, including maintaining good-first-issues, ensuring beginner-friendly documentation, and fostering a welcoming community with fast PR reviews.
  • Phase 2: Building Visibility: Outlined plans to increase project visibility through content creation (blogs, talks, demos), active engagement in CNCF TAGs and Kubernetes Slack channels, and strategic partnership outreach.
  • Phase 3: Cultivating Maintainers: Defined a process for progressing contributors up a ladder, assigning shared ownership of components, and implementing formal mentorship programs, including participation in LFX Mentorship.
  • Metrics and Risk Mitigation: Included measurable targets for external contributors, reviewers, and maintainers, along with identified risks and their corresponding mitigation strategies to ensure the plan's success.
Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature Command Description
Code Review /gemini review Performs a code review for the current pull request in its current state.
Pull Request Summary /gemini summary Provides a summary of the current pull request in its current state.
Comment @gemini-code-assist Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help /gemini help Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for GitHub and other Google products, sign up here.

Footnotes

  1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution.

Copy link
Copy Markdown

@gemini-code-assist gemini-code-assist bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request introduces a comprehensive MULTI_ORG_MAINTAINERSHIP.md document, outlining a three-phase strategy to attract and cultivate external maintainers for KubeOrch. The plan is well-structured, detailing actions for lowering barriers, building visibility, and formalizing mentorship. It also includes measurable targets and risk mitigations, which are crucial for tracking progress. The overall strategy appears sound and aligns well with the project's goal of achieving multi-organization maintainership for CNCF sandbox acceptance.


**Contributor Ladder Progression**
- Actively identify consistent contributors
- Invite regular contributors to become Reviewers (see [CONTRIBUTOR_LADDER.md](https://github.com/KubeOrch/community/blob/main/CONTRIBUTOR_LADDER.md))
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The link to CONTRIBUTOR_LADDER.md appears to be broken or refers to a file that does not exist in the repository. Please ensure this document is created and accessible, or update the link to point to the correct resource (e.g., a section within GOVERNANCE.md if that's where the contributor ladder details reside). A broken link can hinder contributors from understanding the progression path.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

must-fix-for-cncf Required for CNCF Sandbox submission

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Develop plan for multi-organization maintainership

1 participant