Skip to content

Latest commit

 

History

History
36 lines (19 loc) · 3.54 KB

REPOSITORIES.md

File metadata and controls

36 lines (19 loc) · 3.54 KB

Repositories

This document describes the lifecycle of repositories under the Notary Project organization.

Anyone can submit proposals regarding repositories' lifecycle by opening a GitHub issue in the notaryproject/.github repository. The Notary Project governance maintainers will take into account the community feedback and decide on the proposal.

Create a new sub-project

A new sub-project can be created as a repository and contributed to the Notary Project organization by opening a GitHub issue to request Notary Project governance maintainers to vote in the notaryproject/.github repository. A new sub-project can be created after having a supermajority (two-thirds) of approval from Notary Project governance maintainers.

If the decision is to add the proposed project, then one of the Notary Project GitHub organization admins will assist the issue opener in creating a repository or transferring an existing repository to the Notary Project organization. Upon creation, the repository must be reviewed to make sure it follows the Notary Project Governance.

Lifecycle change

A repository can be archived if no activity like Pull Requests for a year. The sub-project maintainers of a given repository can propose changing its status by opening a GitHub issue in the notaryproject/.github repository. The Notary Project governance maintainers will take into account the community feedback and decide on the proposal. The project status should be stated in the README of the repository.

Archiviation

Repositories may become stale, showing little to no activity during the time span of a year. They can be proposed for Archiviation by opening a GitHub issue. The repository-level maintainers should be noticed about this archiviation issue. Once the proposal issue has a supermajority (two-thirds) of approval from Notary Project governance maintainers and there is no response from the repository-level maintainers after 30 days notice, the repository can be archived. Archived repositories will remain inside the Notary Project GitHub organization but will be read-only and will not be maintained. As such, CODEOWNERS files contained in archived repositories are not valid.

In some cases, a repository is archived to reserve its name for future use.

Unarchiviation

Archived repositories can be proposed for unarchiviation by opening a GitHub issue in the notaryproject/.github repository. Once the proposal issue has a supermajority (two-thirds) of approval from Notary Project governance maintainers, the archived repository can be changed to active. In general, the same rules as for new repositories apply.

Rename

The name of a repository might be changed for some reasons. Renaming repositories can be proposed with sufficient reasons for renaming by opening a GitHub issue in the notaryproject/.github repository. Once the proposal issue has a supermajority (two-thirds) of approval from Notary Project governance maintainers, the repository can be renamed.

Credits

Parts of the content are borrowed from falcosecurity/evolution.