[Governance Review]: CubeFS

leonrayang commented 3 months ago

Project Name

CubeFS

Project Website

https://cubefs.io/

Contact Details 1

changliang@oppo.com

Contact Details 2

hexiaochun@oppo.com

Links to communication channels

cubefs.slack.com

Reason for governance review request

Application for moving levels from Incubation to Graduation

Are there any sub-projects, plugins, and related?

No, https://github.com/cubefs/cubefs is the main project. In addition, the remaining repositories primarily focus on hosting essential components and providing solutions.

Governance model

CubeFS largely adheres to the CNCF governance template and is further improved compared to the template.

CubeFS is governed by a steering committee responsible for overall project planning.
The steering committee holds regular meetings to review and formally represent the voice of the community. As long as there is sufficient consensus, obtaining recognition from existing maintainers, and receiving approval through a vote by the steering committee, anyone can become a maintainer.
Maintainers are responsible for maintaining and iterating on project kernel modules, while committers contribute to version development, key module design, and community maintenance.
The steering committee members are core maintainers.
CubeFS is building SIGs, which are responsible for non-core modules or items of the project, such as documentation, integration with Kubernetes for management or deployment-related matters, and other related topics. The members and appointment rules of SIGs have also passed public reviews, and they will be updated in the governance document in the future.

Governance documents

Project purpose File storage and object storage are key in the storage domain. CubeFS is a file storage system that provides cloud-native file system capabilities and is compatible with object storage. Moreover, it offers a multitude of competitive features and capabilities.
- CubeFS Introduction: link
- The project’s differentiation is the main feature of CubeFS: link to md#section
Maintainer List (with employer information) Maintainers of CubeFS coming from JD, OPPO, BEIKE etc.: link to md#section
How your project is making decisions Decision making process on leadership roles: link to md#section
How and when contributors are moving through the contributor ladder (e.g. becoming a maintainer) How to become a maintainer: link to md#section
- Maintainer life cycle with information about how and when maintainers are demoted Document changes in maintainership,onboarding, offboarding: link to md#section
Code of Conduct link to md#section
Contributor Guide link
How your community conduct communication and meetings
- The communication channels for all CubeFS projects are shared: link
- CubeFS Meeting-Schedule: link
- CubeFS meeting schedulers already added to CNCF calendar: link
How your community handles security reporting and response link
Who owns what code and docs
- Maintainers have expertise in the domain fields of the project and are listed in the maintainer documentation.link to md#section
- The top 6 contributors with the highest number of contributions are all maintainers.link

Governance Execution Examples

Voting Governance has continuously been iterated upon by the project as a result of their experience applying it, with the governance history demonstrating evolution of maturity alongside the project's maturity evolution.
- Update the document of the roadmap to improve readability and include features that are in preparation but not yet scheduled: https://github.com/cubefs/cubefs/pull/3358
- The establishment of the Steering Committee and clarification of its members in CubeFS: https://github.com/cubefs/cubefs/pull/3311#issue-2238919813
- Update the Governance Document by most of maintainers: https://github.com/cubefs/cubefs/pull/3312
- Update the Governance Document to eliminate the role of the leader:https://github.com/cubefs/cubefs/pull/3382
- Update maintainer list according to activity and add steering commitee member: https://github.com/cubefs/cubefs/pull/3311
- Update the Governance Document to add governance rules related to SIGs.: link to pr
- Update the Governance Document to add governance rules related to RoadMap.: link to pr
Promoting a contributor / demoting a maintainer
- Add a commiter https://github.com/cubefs/cubefs/pull/3386
- The latest personnel changes are based on the new governance document and voting principles.https://github.com/cubefs/cubefs/pull/3311
- Historical changes: The maintainer update is due to insufficient activity levels from many individuals.https://github.com/cubefs/cubefs/pull/3044
Security response
- Please reference: link to md#section
- CubeFS have passed the Third Party Security Review: link
- Some advisories already be fixed link
Meeting recordings
- CubeFS Meeting-Schedule: link
- CubeFS meeting schedulers already added to CNCF calendar: link

Governance Evolution

Governance has continuously been iterated upon by the project as a result of their experience applying it, with the governance history demonstrating evolution of maturity alongside the project's maturity evolution.

The establishment of the Steering Committee and clarification of its members in CubeFS: https://github.com/cubefs/cubefs/pull/3311#issue-2238919813
Update the Governance Document by most of maintainers: https://github.com/cubefs/cubefs/pull/3312
Update the Governance Document to eliminate the role of the leader:https://github.com/cubefs/cubefs/pull/3382
Add a commiter through voting by steer committe and maintainers : https://github.com/cubefs/cubefs/pull/3386
Adding governance rules related to SIGs.: link to pr
Adding governance rules related to RoadMap.: link to pr

Any specific aspects of your governance structure are you seeking feedback on?

No response

Do you have any concerns or specific areas where you feel your governance could be improved?

No response

Additional notes and resources

No response

aliok commented 1 month ago

@leonrayang

For transparency, I've started this assessment. Here's my working document: https://docs.google.com/document/d/1xd8hCw0O-RiotwO5A046UFU1l_9XLhDK2ZxfVAUa0rg/edit

However, you don't have to start addressing the issues in the document right now. That's not the purpose of this document at this stage.

I am using a commit (https://github.com/cubefs/cubefs/tree/1536a544f2d9547647ad4e260edade60163e3585) and I won't see the changes you make.

Feel free to add comments in the document, if you think I misunderstood some things.

cc @jberkus @geekygirldawn

leonrayang commented 1 month ago

@leonrayang

For transparency, I've started this assessment. Here's my working document: https://docs.google.com/document/d/1xd8hCw0O-RiotwO5A046UFU1l_9XLhDK2ZxfVAUa0rg/edit

However, you don't have to start addressing the issues in the document right now. That's not the purpose of this document at this stage.

I am using a commit (https://github.com/cubefs/cubefs/tree/1536a544f2d9547647ad4e260edade60163e3585) and I won't see the changes you make.

Feel free to add comments in the document, if you think I misunderstood some things.

cc @jberkus @geekygirldawn

@aliok We greatly appreciate your work. I have responded to some of your comments to clarify certain points for your understanding. Of course, I also believe that most comments need us to further clarify and optimize. Thank you very much!

leonrayang commented 3 weeks ago

@aliok

Hi aliok,

I proposed the governance review in the TCS a few days ago and greatly appreciate your work. We have now made adjustments and additions based on your suggestions. Please take a look at the document

This is the pull request that update the governance-related documentation based on your recommendations: cubefs/cubefs#3478

cncf / tag-contributor-strategy