Skip to content

Commit 9f2f93b

Browse files
committed
Add GOVERNANCE file documenting change review
Define the roles of participants in the project and document the expected change review process for the specification. Signed-off-by: Joshua Lock <[email protected]>
1 parent 54aa2eb commit 9f2f93b

File tree

1 file changed

+66
-0
lines changed

1 file changed

+66
-0
lines changed

GOVERNANCE.md

Lines changed: 66 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,66 @@
1+
# Governance
2+
3+
## Project Roles
4+
5+
### Contributors
6+
7+
Individuals who want to contribute ideas to the TUF specification. Cleanups and
8+
clarifications are discussed in [GitHub Issues](
9+
https://github.com/theupdateframework/specification/issues)
10+
and submitted as [GitHub Pull Requests](
11+
https://github.com/theupdateframework/specification/pulls).
12+
13+
New ideas and enhancements to the specification are submitted through the [TUF
14+
Augmentation Proposal (TAP) process](
15+
https://github.com/theupdateframework/taps/blob/master/tap1.md).
16+
17+
### Consensus Builder
18+
19+
Ultimate authority for changes to the TUF specification, including changes
20+
proposed through the [TAP process](
21+
https://github.com/theupdateframework/taps/blob/master/tap1.md), falls to the
22+
specification's Consensus Builder.
23+
24+
### TAP Editors
25+
26+
The TAP Editors are a team of core contributors to the TUF project who are
27+
responsible for reviewing and approving, or rejecting, any proposed
28+
[TAPs](https://github.com/theupdateframework/taps) and changes to the
29+
specification.
30+
31+
32+
## Change Review Process
33+
34+
__All changes must be submitted as a GitHub Pull Request (PR)__
35+
36+
The submitter of the PR is responsible for responding to feedback from
37+
reviewers and maintainers. While the PR remains open the submitter is also
38+
responsible for ensuring the change is in a state which can be merged.
39+
40+
__All minor changes must be approved by at least two (2) other TAP editors__
41+
42+
Obvious language correctness (grammar and typo fixes), or other changes that
43+
do not significantly alter the specification must be approved by at least two
44+
(2) TAP Editors. These minor changes do not require a contemplation period.
45+
46+
__All major changes must be approved by at least two (2) other TAP editors,
47+
and merged no sooner than five (5) business days after submission__
48+
49+
In order to ensure the security properties of TUF are maintained it is
50+
necessary to contemplate how any changes to the specification may affect those
51+
security properties. Therefore, all PRs containing non-minor changes will
52+
remain open for at least five (5) business days to allow all interested TAP
53+
Editors time to review the submission.
54+
55+
A TAP editor may request longer to consider the changes, so long as that
56+
request is made within the initial five (5) business day contemplation period.
57+
58+
Non-minor changes to the specification require two (2) TAP editor approvals.
59+
60+
Major changes should not be merged when there are outstanding changes
61+
requested. In cases where the requested changes are not agreeable to the
62+
submitter, and therefore will not be made, the request for changes should be
63+
revoked by the requesting TAP editor.
64+
When consensus can not be agreed between submitter and TAP editors,
65+
the Consensus Builder holds ultimate authority on whether to accept the
66+
proposed change.

0 commit comments

Comments
 (0)