Skip to content

Commit 53d7cde

Browse files
committed
Tidy up and break out section for ADRs
1 parent 9399fbf commit 53d7cde

File tree

1 file changed

+11
-7
lines changed

1 file changed

+11
-7
lines changed

CHARTER.md

Lines changed: 11 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -134,31 +134,35 @@ Transition between stages may be requested by anyone, but must be called by the
134134

135135
Most of the discussion should happen within the same Discussion. Groups looking to form a proposal or amend a proposal (stages 4 and 5) may make use of other additional Discussions or Issues, but these must be clearly linked. The opening comment should be updated to include links to relevant specific threads and comments in the same Discussion, and any other relevant locations.
136136

137-
Moving to the 'Form a proposal" stage should be approached when the group might feel able to combine ideas to form a single proposal. Multiple possible solutions should be discussed in the previous stage.
137+
Moving to the 'Form a Proposal" stage should be approached when the group might feel able to combine ideas to form a single proposal. Multiple possible solutions should be discussed in the previous stage.
138138

139139
The "Test for Agreement" step is not voting, and is in stead asking for "signals", which enable the consensus process to continue.
140140
Voting should be considered a last resort if the consensus process has failed for a particular issue, to enable the project to move forward.
141141

142-
If someone calls for a Test of Agreement, the facilitator for the Discussion will review current proposal and may call to Test for Agreement. The facilitator will post a comment on the Discussion (using the provided template), linking to the current version of the proposal, and update the opening comment with a link to the new comment. TSC members will then be asked to signal their agreement using reactions on the comment.
142+
If someone calls for a Test of Agreement, the facilitator for the Discussion will review current proposal and may call to Test for Agreement. The facilitator will post a comment on the Discussion (using the provided template), linking to the current version of the proposal, and update the opening comment with a link to the new comment. TSC members will then be asked to signal their agreement using GitHub Reactions on the comment.
143143

144-
The "Determine resolution" step should result in the creation of an [Any Decision Record](./docs/adr/README.md).
144+
The "Determine resolution" step should result in the creation of an [Any Decision Record](./docs/adr/README.md). More details in following sections.
145145

146146
#### Decision-making via vote
147147

148-
Any call for public TSC votes will be made by creating an Issue in the community repo with the tsc-vote label assigned. The Issue should use the provided template.
148+
Any call for public TSC votes will be made by creating an Issue in the community repo with the `tsc-vote` label assigned. The Issue should use the provided template.
149149
--? Should public votes go in the community repo or a new TSC repo?--
150150

151-
Once an Issue gains the label tsc-vote, all members of the TSC will be notified via a specific Slack channel (and by any additional method the TSC deems helpful). The votes will be collected by way of using GitHub Reactions on a specific comment, which must not be the first comment. The first comment must link to the voting comment in the same Issue.
151+
Once an Issue gains the label `tsc-vote`, all members of the TSC will be notified via a specific Slack channel (and by any additional method the TSC deems helpful). The votes will be collected by way of using GitHub Reactions on a specific comment, which must not be the first comment. The first comment must link to the voting comment in the same Issue.
152152
Voting will by default close after 7 days. Any member of the TSC may request a 7 day extension for any reason, moving the closing date back by 7 days. Any member of the TSC may request additional extensions, approved at the discretion of any TSC chair.
153153

154154
For a vote to carry, a quorum of 75% is required by default.
155155

156156
If a TSC member wants to call for a vote that they wish to be non-public, they must do so by contacting the TSC Chairs directly.
157-
At the discretion of the TSC Chairs, a vote may made non-public, and will then be handled by creating a Discussion in the orgs TSC Team page (?-- Or should this be an Issue in a private repo? That might be preferable as they can then be closed--). The topic and nature of non-public votes may remain non-public, including the results.(It is expected that vast majority of votes will be public. Non-public voting should only be used in exceptional circumstances.)
157+
At the discretion of the TSC Chairs, a vote may be made non-public, and will then be handled by creating a Discussion in the orgs TSC Team page (?-- Or should this be an Issue in a private repo? That might be preferable as they can then be closed--). The topic and nature of non-public votes may remain non-public, including the results.(It is expected that vast majority of votes will be public. Non-public voting should only be used in exceptional circumstances.)
158+
159+
#### Documenting decisions
158160

159161
Either initially, or at any point during the process, any TSC member may suggest the issue being discussed is "significant or noteworthy." If there are no objections, the resolution actions for the issue must include the creation of an Any Decision Record (Previously named Architectural Decision Record). The Any Decision Record (ADR) should include as much information as is thought to be useful, following the provided template. The Pull Request for the ADR must be approved by all those who were involved in the decision making process, which must also be documented in the ADR as the "deciders."
160162

161-
(The short consensus process does not require a Decision Record, but the decision should be minuted.)
163+
(The quick consensus process does not require a Decision Record, but the decision should be minuted.)
164+
165+
Non-public decisions should be documented (as an ADR or otherwise) in the private `private-tsc` repo.
162166

163167
### Section 4.3: Other Project Roles (optional)
164168

0 commit comments

Comments
 (0)