You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: pages/design/process.md
+14-11Lines changed: 14 additions & 11 deletions
Original file line number
Diff line number
Diff line change
@@ -1,5 +1,5 @@
1
1
---
2
-
title: Process
2
+
title: ACT-Rules CG Process
3
3
---
4
4
5
5
## Overview of process/workflow in ACT Rules Community Group:
@@ -14,7 +14,7 @@ title: Process
14
14
15
15
(see workflow on the board here: https://github.com/act-rules/act-rules.github.io/projects/5)
16
16
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.
18
18
19
19
## Ideas looking for initial approvals
20
20
@@ -38,11 +38,11 @@ The purpose of this stage is to avoid that people spend a huge amount of time on
38
38
39
39
#### Rule author's job for this stage:
40
40
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.
42
42
43
43
#### Reviewer's job for this stage:
44
44
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.
46
46
- 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.
47
47
- 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.
48
48
@@ -83,7 +83,7 @@ Rule writing
83
83
84
84
### Passes this stage when:
85
85
86
-
- There are no open comments from reviewers.
86
+
- There are no open comments from reviewers to be addressed.
87
87
88
88
### Fails this stage and moves back a stage to "To Do" when:
89
89
@@ -127,7 +127,7 @@ Rules that have been fixed up by the author and are ready for review again, aimi
127
127
#### Reviewer's job for this stage:
128
128
129
129
- 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.
131
131
- If you consider the rule to be:
132
132
- ... ready for publication --> Use "Approve" status
133
133
- ... 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)
150
150
#### Changes that do require a "Call for Review"
151
151
152
152
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:
@@ -193,15 +193,18 @@ If this happens, a new "Call for Review" should be launched after the first one.
193
193
- 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.
194
194
- Keep up to date on Calls for Review using this list: https://github.com/act-rules/act-rules.github.io/issues/461
195
195
196
-
###Done
196
+
## Done
197
197
198
198
Published rules
199
199
200
200
### Enters this stage when:
201
201
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)
203
206
204
-
###Rejected
207
+
## Rejected
205
208
206
209
Rules that have been rejected due to different reasons.
0 commit comments