Skip to content

Commit 73aca56

Browse files
committed
Cleanup markdown in governance
- Email addresses should be enclosed in brackets, same as links. - Release approval header missing, replaced with proposing a motion. - Replaced runtime-spec with image-spec in examples. - Proposing a motion header was in the document twice, renamed. Signed-off-by: Brandon Mitchell <[email protected]>
1 parent b5ec432 commit 73aca56

File tree

1 file changed

+9
-9
lines changed

1 file changed

+9
-9
lines changed

GOVERNANCE.md

Lines changed: 9 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -8,11 +8,11 @@ This section describes generic rules and procedures for fulfilling that mandate.
88

99
## Proposing a motion
1010

11-
A maintainer SHOULD propose a motion on the [email protected] mailing list (except [security issues](#security-issues)) with another maintainer as a co-sponsor.
11+
A maintainer SHOULD propose a motion on the <[email protected]> mailing list (except [security issues](#security-issues)) with another maintainer as a co-sponsor.
1212

1313
## Voting
1414

15-
Voting on a proposed motion SHOULD happen on the [email protected] mailing list (except [security issues](#security-issues)) with maintainers posting LGTM or REJECT.
15+
Voting on a proposed motion SHOULD happen on the <[email protected]> mailing list (except [security issues](#security-issues)) with maintainers posting LGTM or REJECT.
1616
Maintainers MAY also explicitly not vote by posting ABSTAIN (which is useful to revert a previous vote).
1717
Maintainers MAY post multiple times (e.g. as they revise their position based on feedback), but only their final post counts in the tally.
1818
A proposed motion is adopted if two-thirds of votes cast, a quorum having voted, are in favor of the release.
@@ -29,12 +29,12 @@ However, a motion MAY be adopted with REJECTs, as outlined in the previous parag
2929

3030
A quorum is established when at least two-thirds of maintainers have voted.
3131

32-
For projects that are not specifications, a [motion to release](#release-approval) MAY be adopted if the tally is at least three LGTMs and no REJECTs, even if three votes does not meet the usual two-thirds quorum.
32+
For projects that are not specifications, a [motion to release](#proposing-a-motion) MAY be adopted if the tally is at least three LGTMs and no REJECTs, even if three votes does not meet the usual two-thirds quorum.
3333

3434
## Security issues
3535

36-
Motions with sensitive security implications MUST be proposed on the [email protected] mailing list instead of [email protected], but should otherwise follow the standard [proposal](#proposing-a-motion) process.
37-
The [email protected] mailing list includes all members of the TOB.
36+
Motions with sensitive security implications MUST be proposed on the <[email protected]> mailing list instead of <[email protected]>, but should otherwise follow the standard [proposal](#proposing-a-motion) process.
37+
The <[email protected]> mailing list includes all members of the TOB.
3838
The TOB will contact the project maintainers and provide a channel for discussing and voting on the motion, but voting will otherwise follow the standard [voting](#voting) and [quorum](#quorum) rules.
3939
The TOB and project maintainers will work together to notify affected parties before making an adopted motion public.
4040

@@ -48,15 +48,15 @@ The MAINTAINERS of this project governance document is the total set of MAINTAIN
4848
Maintainers are busy and get lots of email.
4949
To make project proposals recognizable, proposed motions SHOULD use the following subject templates.
5050

51-
### Proposing a motion
51+
### Proposing a motion template
5252

5353
> [{project} VOTE]: {motion description} (closes {end of voting window})
5454
5555
For example:
5656

57-
> [runtime-spec VOTE]: Tag 0647920 as 1.0.0-rc (closes 2016-06-03 20:00 UTC)
57+
> [image-spec VOTE]: Tag 0647920 as 1.0.0-rc (closes 2016-06-03 20:00 UTC)
5858
59-
### Tallying results
59+
### Tallying results template
6060

6161
After voting closes, a maintainer SHOULD post a tally to the motion thread with a subject template like:
6262

@@ -65,6 +65,6 @@ After voting closes, a maintainer SHOULD post a tally to the motion thread with
6565
Where `{status}` is either `adopted` or `rejected`.
6666
For example:
6767

68-
> [runtime-spec adopted]: Tag 0647920 as 1.0.0-rc (+6 -0 #3)
68+
> [image-spec adopted]: Tag 0647920 as 1.0.0-rc (+6 -0 #3)
6969
7070
[charter]: https://github.com/opencontainers/tob/blob/main/CHARTER.md

0 commit comments

Comments
 (0)