Skip to content

docs: add project and repository inventory - #96

Open
yada wants to merge 2 commits into
mainfrom
governance/project-inventory
Open

docs: add project and repository inventory#96
yada wants to merge 2 commits into
mainfrom
governance/project-inventory

Conversation

@yada

@yada yada commented Sep 9, 2026

Copy link
Copy Markdown
Member

Summary

  • add a canonical inventory of Microcks public first-party repositories
  • document each repository's purpose, category, lifecycle and responsible ownership
  • retain archived repositories and record deliberate exclusions
  • link CNCF CLOMonitor as an external health and conformance reference
  • link the inventory from the organization profile README

Context

This addresses the repository and subproject inventory follow-up identified during the CNCF review in cncf/toc#2099.

CLOMonitor covers selected delivered components and documentation repositories. SUBPROJECTS.md remains authoritative for Microcks repository scope, lifecycle and ownership.

Validation

  • compared the inventory with the current repositories in the Microcks GitHub organization
  • confirmed 41 active and 4 archived public first-party repositories
  • confirmed that external forks and private repositories are excluded
  • checked Markdown formatting and whitespace

Decision process

This adds a supporting governance document and therefore requires a formal organization-balanced Maintainer vote under GOVERNANCE.md.

Signed-off-by: Yacine Kheddache <yacine@microcks.io>
@yada

yada commented Sep 9, 2026

Copy link
Copy Markdown
Member Author

Formal Maintainer vote

This PR adds SUBPROJECTS.md as the canonical inventory for Microcks repository scope, lifecycle and ownership. As a supporting governance document, it requires a formal organization-balanced vote under our governance rules.

Eligible affiliations:

Affiliation Eligible Maintainers Position
Postman @lbroudoux, @yada Pending
AXA France @SebastienDegodez Pending

Please reply with:

  • +1 — approve
  • 0 — abstain
  • -1 — oppose, with an explanation

The vote opens on September 9, 2026 and remains open through September 23, 2026, unless it can be closed early because the outcome can no longer change.

Approval requires both eligible organizational votes. For Postman, a majority of its two Maintainers is required to establish its position. Community comments are welcome, but only eligible Maintainers determine the binding organizational votes.

@yada

yada commented Sep 9, 2026

Copy link
Copy Markdown
Member Author

My vote: +1 (binding)

@yada yada added the documentation Improvements or additions to documentation label Sep 9, 2026
Signed-off-by: Yacine Kheddache <yacine@microcks.io>
@yada

yada commented Sep 9, 2026

Copy link
Copy Markdown
Member Author

The PR has been updated to link the canonical inventory from GOVERNANCE.md. This is a related discoverability change and does not replicate SUBPROJECTS.md.

I reconfirm my +1 vote for the updated PR at commit 54744b7.

Comment thread SUBPROJECTS.md

@lbroudoux lbroudoux left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

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

LGTM

@lbroudoux

Copy link
Copy Markdown
Member

My vote: +1 (binding)

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.

2 participants