What is an ACT rule - Issue 292 #310
Closed
Conversation
This file contains bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
annethyme
reviewed
Nov 29, 2018
| @@ -342,6 +342,7 @@ <h2 class="heading settled" data-level="1" id="intro"><span class="secno">1. </s | |||
| <p>There are currently many test procedures and tools available which aid their users in testing web content for conformance to accessibility standards such as the <a href="https://www.w3.org/WAI/standards-guidelines/wcag/">Web Content Accessibility Guidelines (WCAG)</a> <a data-link-type="biblio" href="#biblio-wcag">[WCAG]</a>. As the web develops in both size and complexity, these procedures and tools are essential for managing the accessibility of resources available on the web.</p> | |||
| <p>This format is intended to enable a consistent interpretation of how to test for <a href="#accessibility-requirements">accessibility requirements</a> and promote consistent results of accessibility tests. It is intended to be used to describe both manual accessibility tests as well as automated tests performed by accessibility testing tools.</p> | |||
| <p>Describing how to test certain accessibility requirements will result in accessibility tests that are transparent, with test results that are reproducible. The Accessibility Conformance Testing (ACT) Rules Format defines the requirements for these test descriptions, known as Accessibility Conformance Testing Rules (ACT Rules).</p> | |||
| <p>Each ACT Rule is a plain English description of what type of content is being tested, the test it performs, and the expected result. Where the test result affects conformance, the rule documents which particular requirement the test is for. The resulting outcomes from the test can be used to help determine conformance or non-conformance to the requirement. Test cases are also written as part of the ACT rule to provide a way to verify that implementations of the rule can successfully determine the expected pass and fail outcomes.</p> | |||
There was a problem hiding this comment.
Does ACT Rules have to be in English? Can we say "plain language description" and allow for ACT Rules written in other languages?
There was a problem hiding this comment.
Should it say something about that ACT Rules Format defines requirements for which items a rules must contain to be an ACT Rule, or that ACT Rules have a certain structure?
And maybe also that there are different types of ACT Rules?
It would be nice if this intro was a high level summary of "everything in the spec".
There was a problem hiding this comment.
I think we should avoid passive English as well, e.g. "being tested" should rather be "content under test".
There was a problem hiding this comment.
Note: Updates are to HTML file and need to be made against Bikeshed file, act-rules-format.bs.
WilcoFiers
reviewed
Dec 13, 2018
| @@ -342,6 +342,7 @@ <h2 class="heading settled" data-level="1" id="intro"><span class="secno">1. </s | |||
| <p>There are currently many test procedures and tools available which aid their users in testing web content for conformance to accessibility standards such as the <a href="https://www.w3.org/WAI/standards-guidelines/wcag/">Web Content Accessibility Guidelines (WCAG)</a> <a data-link-type="biblio" href="#biblio-wcag">[WCAG]</a>. As the web develops in both size and complexity, these procedures and tools are essential for managing the accessibility of resources available on the web.</p> | |||
| <p>This format is intended to enable a consistent interpretation of how to test for <a href="#accessibility-requirements">accessibility requirements</a> and promote consistent results of accessibility tests. It is intended to be used to describe both manual accessibility tests as well as automated tests performed by accessibility testing tools.</p> | |||
| <p>Describing how to test certain accessibility requirements will result in accessibility tests that are transparent, with test results that are reproducible. The Accessibility Conformance Testing (ACT) Rules Format defines the requirements for these test descriptions, known as Accessibility Conformance Testing Rules (ACT Rules).</p> | |||
| <p>Each ACT Rule is a plain English description of what type of content is being tested, the test it performs, and the expected result. Where the test result affects conformance, the rule documents which particular requirement the test is for. The resulting outcomes from the test can be used to help determine conformance or non-conformance to the requirement. Test cases are also written as part of the ACT rule to provide a way to verify that implementations of the rule can successfully determine the expected pass and fail outcomes.</p> | |||
There was a problem hiding this comment.
This change should be made to the markdown file, not the HTML file. Otherwise we'd lose it.
|
@maryjom Closing pull request to get changes in .bs file. Thanks, Moe |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
See Issue #292