Skip to content

Commit be01a9a

Browse files
daniel-montalvocarlosapaduarteWilcoFiers
authored
Updates process (#2316)
* Updates process * Fix heading level * Update pages/design/process.md Co-authored-by: Wilco Fiers <WilcoFiers@users.noreply.github.com> --------- Co-authored-by: Carlos Duarte <carlosapaduarte@gmail.com> Co-authored-by: Wilco Fiers <WilcoFiers@users.noreply.github.com>
1 parent b4e371c commit be01a9a

File tree

1 file changed

+14
-11
lines changed

1 file changed

+14
-11
lines changed

pages/design/process.md

Lines changed: 14 additions & 11 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,5 @@
11
---
2-
title: Process
2+
title: ACT-Rules CG Process
33
---
44

55
## Overview of process/workflow in ACT Rules Community Group:
@@ -14,7 +14,7 @@ title: Process
1414

1515
(see workflow on the board here: https://github.com/act-rules/act-rules.github.io/projects/5)
1616

17-
**Note:** The steps in the process, as outlined above, are agreed upon by the ACT Rules Community Group on teleconference calls. This document however, is still work in progress.
17+
**Note:** The steps in the process, as outlined above, are agreed upon by the ACT Rules Community Group on teleconference calls.
1818

1919
## Ideas looking for initial approvals
2020

@@ -38,11 +38,11 @@ The purpose of this stage is to avoid that people spend a huge amount of time on
3838

3939
#### Rule author's job for this stage:
4040

41-
- Creating the pull request (PR) for the rule already at this stage is recommended, but for content of the rule it should be enough to have e.g. a title, a description and success criteria listed, for reviewers to be able to evaluate the idea for the rule. Creating the rule as a pull request already here allows for keeping the discussion of the rule in one place. However, if a rule writer prefers using issues at this stage, this is also allowed.
41+
- Creating the pull request (PR) for the rule already at this stage is recommended, but for content of the rule it should be enough to have e.g. a title, a description and accessibility requirements listed, for reviewers to be able to evaluate the idea for the rule. Creating the rule as a pull request already here allows for keeping the discussion of the rule in one place. However, if a rule writer prefers using issues at this stage, this is also allowed.
4242

4343
#### Reviewer's job for this stage:
4444

45-
- Focus on whether the rule is a valid test for the accessibility requirements (WCAG success criteria) that it lists.
45+
- Focus on whether the rule is a valid test for the accessibility requirements (e.g. WCAG success criteria) that it lists.
4646
- Focus on whether you can agree to the general concept of the rule, or if the idea needs to be tweaked or rejected all together.
4747
- Be honest about your concerns, since rejecting a rule at this point will save a lot of resources compared to rejecting it at the Call for Review later.
4848

@@ -83,7 +83,7 @@ Rule writing
8383

8484
### Passes this stage when:
8585

86-
- There are no open comments from reviewers.
86+
- There are no open comments from reviewers to be addressed.
8787

8888
### Fails this stage and moves back a stage to "To Do" when:
8989

@@ -127,7 +127,7 @@ Rules that have been fixed up by the author and are ready for review again, aimi
127127
#### Reviewer's job for this stage:
128128

129129
- Review the rule thoroughly.
130-
- Use the [Definition of Done](https://act-rules.github.io/pages/design/definition-of-done/) as a checklist for the review.
130+
- Use the [Definition of Done](https://github.com/act-rules/act-rules.github.io/blob/develop/pages/design/definition-of-done.md) as a checklist for the review.
131131
- If you consider the rule to be:
132132
- ... ready for publication --> Use "Approve" status
133133
- ... in need of changes, big or small (even if you didn't do a full review) --> Use "Request changes" status (and make comments)
@@ -150,9 +150,9 @@ This stage was formerly called Final Call or Call for Consensus (CFC)
150150
#### Changes that do require a "Call for Review"
151151

152152
Substantial changes, that require a "Call for Review", are in general changes that can affect the outcome of a rule.
153-
This includes, but might not be limited to changes that changes, extends or limits the scope of what is considered for these sections:
153+
This includes, but might not be limited to modifications that change, extend, or limit the scope of what is considered for these sections:
154154

155-
- Accessibility Requirements (success criteria)
155+
- Accessibility Requirements (e.g. success criteria)
156156
- Applicability
157157
- Expectations
158158
- Test cases (Passed/Failed/Inapplicable)
@@ -193,15 +193,18 @@ If this happens, a new "Call for Review" should be launched after the first one.
193193
- Be aware that this is last chance to object to the rule, on everything from spelling and grammar to accessibility requirements mapping and use of definitions.
194194
- Keep up to date on Calls for Review using this list: https://github.com/act-rules/act-rules.github.io/issues/461
195195

196-
### Done
196+
## Done
197197

198198
Published rules
199199

200200
### Enters this stage when:
201201

202-
- A rule has received 3 approvals from 3 different organizations and successfully survived its 2 week Call for Review (if applicable), and has been merged and is now shown on rules overview on the website: https://act-rules.github.io/rules/ (might take a few minutes to update after merge).
202+
- A rule has:
203+
- received 3 approvals from 3 different organizations,
204+
- went through Call for Review (if applicable), and change requests have been resolved
205+
- been merged and published as a proposed rule in the WAI website at https://www.w3.org/WAI/standards-guidelines/act/rules/ (ACT Rules on the WAI website are generally updated every Tuesday)
203206

204-
### Rejected
207+
## Rejected
205208

206209
Rules that have been rejected due to different reasons.
207210

0 commit comments

Comments
 (0)