Add a GOVERNANCE file #92
Conversation
silvin-lubecki
force-pushed
the
governance
branch
from
d95de1b
to
75dc264
Compare
|
PTAL @radu-matei and @carolynvs 🙏 |
|
|
||
| New maintainers can be added to the project by a [super-majority](https://en.wikipedia.org/wiki/Supermajority#Two-thirds_vote) vote of the existing maintainers. | ||
|
|
||
| A maintainer may step down by submitting an [issue](https://github.com/cnabio/cnab-to-oci/issues/new) stating their intent. |
There was a problem hiding this comment.
In practice, I have seen that we have been having maintainers submit a pull request removing themselves from CODEOWNERS and then having the normal number of reviewers (not a supermajority) approve the PR.
|
|
||
| [Project maintainers](CODEOWNERS) are responsible for activities around maintaining and updating CNAB-TO-OCI, a library for the [CNAB spec](https://github.com/cnabio/cnab-spec). Final decisions on the project reside with the project maintainers. | ||
|
|
||
| Maintainers MUST remain active. If they are unresponsive for >3 months, they will be automatically removed unless a [super-majority](https://en.wikipedia.org/wiki/Supermajority#Two-thirds_vote) of the other project maintainers agrees to extend the period to be greater than 3 months. |
There was a problem hiding this comment.
I realize that we probably copied this from elsewhere, but "automatically" implies that there is an automated process which I don't believe we have.
It may be a good idea to spell out who does the removing. For example, "If they are unresponsive for >3 months, another maintainer may submit a pull request to remove them from CODEOWNERS requiring X approvers unless ..." where X is the usual number of approvers for any other PR.
Otherwise, in my experience people really never get removed because it's awkward and no one knows how to go about it because it's not spelled out.
|
This is the same governance document as the spec repo. If we want to make changes, I would like for the various governance documents for projects to be consistent (and ideally in the same place?) |
|
community is a good place to put template documents |
…how one can become maintainer. Signed-off-by: Silvin Lubecki <silvin.lubecki@docker.com>
silvin-lubecki
force-pushed
the
governance
branch
from
75dc264
to
0e1128a
Compare
|
Rebased onto |
|
I agree with @radu-matei that if we change something to the governance then it should be at the organization level. And I agree too with @carolynvs that we should change the process because we don't respect it strictly in practice. We should add this point to the agenda of the next community meeting 👍 |
|
Bullet point added on the agenda. |
It describes what is the role of maintainers and how one can become maintainer.