Skip to content

docs(governance): introduce incubating subproject concept and update subproject list#5847

Open
jackye1995 wants to merge 4 commits intolance-format:mainfrom
jackye1995:incubator
Open

docs(governance): introduce incubating subproject concept and update subproject list#5847
jackye1995 wants to merge 4 commits intolance-format:mainfrom
jackye1995:incubator

Conversation

@jackye1995
Copy link
Contributor

@jackye1995 jackye1995 commented Jan 29, 2026

See #5848 for more background and vote

@github-actions github-actions bot added the documentation Improvements or additions to documentation label Jan 29, 2026
@github-actions
Copy link
Contributor

PR Review

This is a documentation-only governance update that introduces the "incubating subproject" concept. The changes are well-organized and clearly written.

Summary

The PR restructures the project hierarchy from a two-tier (core + subprojects) to a three-tier model (core + subprojects + incubating subprojects), moves several projects between tiers, and defines clearer graduation criteria.

No Critical Issues Found

This is a governance documentation change with no code impact. The changes are reasonable and provide a clearer path for experimental projects to mature.

Minor Observations (Non-blocking)

  1. Removed graduation criteria: The old graduation path mentioned "Automated release mechanism" and "production use cases" — the new criteria are lighter ("Established use cases" without "production"). This seems intentional for the incubating→subproject path, but there's now no defined graduation path from subproject→core.

  2. Committer privilege note: The note about committers losing privileges upon graduation could benefit from mentioning a timeline or transition period, though this may be intentionally left to PMC discretion.

LGTM — No blocking concerns.

@HaochengLIU HaochengLIU self-requested a review January 29, 2026 19:22
Copy link
Member

@HaochengLIU HaochengLIU left a comment

Choose a reason for hiding this comment

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

lgtm. Feel free to merge it once u are comfortable to publish it

Copy link
Member

@westonpace westonpace left a comment

Choose a reason for hiding this comment

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

Two minor grammar nits

Comment on lines +47 to +49
| Release a new stable major version of core project | 3 | PMC | GitHub Discussions | 1 week |
| Release a new stable minor version of core project | 3 | PMC | GitHub Discussions | 3 days |
| Release a new stable patch version of core project | 3 | PMC | GitHub Discussions | N/A |
Copy link
Member

Choose a reason for hiding this comment

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

Minor nit

Suggested change
| Release a new stable major version of core project | 3 | PMC | GitHub Discussions | 1 week |
| Release a new stable minor version of core project | 3 | PMC | GitHub Discussions | 3 days |
| Release a new stable patch version of core project | 3 | PMC | GitHub Discussions | N/A |
| Release a new stable major version of the core project | 3 | PMC | GitHub Discussions | 1 week |
| Release a new stable minor version of the core project | 3 | PMC | GitHub Discussions | 3 days |
| Release a new stable patch version of the core project | 3 | PMC | GitHub Discussions | N/A |

| Release a new stable patch version of core project | 3 | PMC | GitHub Discussions | N/A |
| Lance Format Specification modifications | 3 (excluding proposer) | PMC | GitHub Discussions (with a GitHub PR) | 1 week |
| Code modifications in core projects (except changes to format specifications) | 1 (excluding proposer) | Maintainers with write access | GitHub PR | N/A |
| Code modifications in core project (except changes to format specifications) | 1 (excluding proposer) | Maintainers with write access | GitHub PR | N/A |
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
| Code modifications in core project (except changes to format specifications) | 1 (excluding proposer) | Maintainers with write access | GitHub PR | N/A |
| Code modifications in the core project (except changes to format specifications) | 1 (excluding proposer) | Maintainers with write access | GitHub PR | N/A |

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

Labels

documentation Improvements or additions to documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants