Rule outline #43
Rule outline #43
Conversation
Rule Outline first draft
act-framework.bs
Outdated
| @@ -35,7 +35,13 @@ ACT Rule Structure {#structure} | |||
| Rule Outline {#structure-outline} | |||
| ----------------------- | |||
|
|
|||
| Editor note: This sections gives a broad outline of parts make up an ACT Rule. We'll go into further detail in sections below. At this point it is important to show the reader the big picture | |||
| A rule MUST provide the following items written in plain language: | |||
| * A descriptive title | |||
There was a problem hiding this comment.
Editorial: Leave a blank line between this paragraph and the list.
There was a problem hiding this comment.
Should we add, pass / fail criteria to the rule outline or do we expect that to be included in the test procedure.
There was a problem hiding this comment.
@cpandhi good idea (as far as I can see): the possible outcomes may differ from one rule to another, so could very well belong to the rule description
There was a problem hiding this comment.
@Charu pass/fail criteria would be part of the test cases. I'm using Auto WCAG as the inspiration.
act-framework.bs
Outdated
| * A descriptive title | ||
| * A unique identifier | ||
| * A rule description | ||
| * Associated criteria, standard(s) or requirement(s) (Note: Auto-WCAG calls this Background) |
There was a problem hiding this comment.
the item above (associated criteria, etc) describe the rationale for the rule.
Another aspect are pointers to remediation techniques (for instance to WCAG Techniques), would that belong to another item?
There was a problem hiding this comment.
@rdeltour Correct. I think the techniques should fall under the test cases.
There was a problem hiding this comment.
@rdeltour During the meeting it was agreed to shorten Associated criteria, standards or requirements to simply Accessibility requirement(s) and to add an item for Related techniques.
Updates based upon feedback from review on Jan. 25, 2017
This update provides a proposal for the Rule outline.
Trying not to be too prescriptive here but are we inherently being prescriptive by generating a rule outline?
Moe