Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Aspects Under Tests - Editorial updates (Shadi) #257

Closed
moekraft opened this issue Sep 6, 2018 · 4 comments
Closed

Aspects Under Tests - Editorial updates (Shadi) #257

moekraft opened this issue Sep 6, 2018 · 4 comments
Assignees

Comments

@moekraft
Copy link
Collaborator

moekraft commented Sep 6, 2018

8.0 Aspects Under Test
An aspect is a distinct part of the test subject or its underlying implementation. For example, rendering a particular piece of content to an end user involves multiple different technologies, some or all of which may be of interest to an ACT Rule. Some rules need to operate directly on the Hypertext Transfer Protocol [http11] messages exchanged between a server and a client, while others need to operate on the Document Object Model [DOM] tree exposed by a web browser.
Atomic rules MUST list the aspects used in the Test Definition. Some rules may need to operate on several aspects simultaneously, such as both the HTTP messages and the DOM tree.
An atomic rule MUST include a description of all the aspects under test by the rule. Some aspects are already well defined in a formal specification within the context of web content, such as HTTP messages, DOM tree, and CSS styling [CSS2]. These do not warrant a detailed description further than a reference to the corresponding section in this specification (see Common Aspects below). For other aspects that are not well defined, an ACT Rule SHOULD include either a detailed description of the aspect in question or a reference to that description.
Each aspect MUST be discrete with no overlap between the aspects.
There SHOULD NOT be an aspects under test list for composed rules.
Accessibility Conformance Testing.docx

@moekraft moekraft self-assigned this Sep 6, 2018
@moekraft
Copy link
Collaborator Author

moekraft commented Sep 6, 2018

Note: Pull request #242 updates section 8.1 Common Aspects Under Test. Keeping these issues and PRs separate.

@moekraft
Copy link
Collaborator Author

Further comments from Shadi during review of PR #242 at weekly WCAG ACT TF meeting, 9/13/18.

[[
An aspect is a distinct part of the Test Subject or its underlying implementation. For example, rendering a particular piece of content to an end user can involve multiple different technologies, some or all of which can be of interest to an ACT Rule. Some rules need to operate directly on the Hypertext Transfer Protocol [[http11]] messages exchanged between a server and a client, while others need to operate on the Document Object Model [[DOM]] tree exposed by a web browser. Other rules need to operate on several aspects simultaneously, such as both the HTTP messages and the DOM tree.

[=Atomic rules=] MUST list the aspects used in the Test Definition. Each aspect MUST be discrete with no overlap between the aspects.

An atomic rule MUST include a description of all the aspects under test by the rule. Some aspects are already well defined within the context of web content, such as HTTP messages, DOM tree, and CSS styling [[CSS2]], and do not warrant a detailed description. Other aspects are not well defined or even specific to web content. In these cases, an ACT Rule SHOULD include either a detailed description of the aspect in question or a reference to that description.

A list of common aspects for reference in ACT rules can be found in Common Aspects under Test.

Since there is no Test Definition in Composed rules, there SHOULD NOT be an aspects under test list for composed rules.
]]

@moekraft
Copy link
Collaborator Author

@WilcoFiers I submitted my edits under PR #274 These reflect Anne and Shadi's feedback as well as feedback from the WCAG ACT Meeting 9/20.

WilcoFiers added a commit that referenced this issue Sep 24, 2018
* Remove aspects MUST requirement #264

* Updated aspects based on feedback #257

* Make test cases required for all rules

* Change "local laws" to "laws" #231

* Add a paragraph on accessibility of rules #226

* Rewrote benchmark to non-normative section #236 #239 #163

* Consistency in rule-aggregation #266

* Tweaked accessibility support language #221

* Changed test subject from MUST to MAY #220

* Require rule IDs in atomic rules list #261

* Fix rule type example #230

* Add rule type to the rule structure #232

* Update from #274

* Add "satify" explanation for Rules to SCs. #227

* Example to "satisfy" WCAG SCs #250

* Scrub document to ensure correct use of "should" and "may" #267

* Break up the PR
@nitedog nitedog added For CR and removed For CR labels Mar 29, 2019
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Projects
None yet
Development

No branches or pull requests

2 participants