Skip to content

Commit f938a8d

Browse files
authored
Style updates (#4242)
Applies the stying changes already done to normative occurrences in #4080 to the Understanding and technique documents. - Ensures all occurrences of "web page" are two words and lower case. - Ensures all occurrences of "website" are a single word, not capitalized. - Ensures all occurrences of "success criterion/criteria" that do not specify SCs by name, are lower case - Ensures all occurrences of "web content" and other uses of "web" are lower case Replaces #3662
1 parent e22d551 commit f938a8d

File tree

270 files changed

+986
-986
lines changed

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

270 files changed

+986
-986
lines changed

conformance-challenges/index.html

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -95,7 +95,7 @@

Problem Statement

9595
algorithms and code happen multiple times per week). It is incumbent on websites - especially for large, complex, dynamic websites - to do everything they can to conform. However, to date, no large, complex software has been bug free. Similarly, authors of large, dynamic, and complex sites have struggled to claim conformance with no accessibility defects on any page.
9696
p>
9797

98-
<p>Assessing conformance of such large, highly complex, dynamic sites to the <a href="https://www.w3.org/TR/WCAG20/">Web Content Accessibility Guidelines (WCAG) 2.0a> [[wcag20]] or <a href="https://www.w3.org/TR/WCAG21/">2.1a> [[wcag21]] has proved difficult. The <a href="https://www.w3.org/TR/WCAG20/#conformance">Web Content Accessibility Guidelines 2.0 include a set of normative requirementsa> <q>in order for a web page to conform to WCAG 2.0,q> including that conformance <q>is for full Web page(s) only, and cannot be achieved if part of a Web page is excluded,q> along with a Note that states <q>If a page cannot conform (for example, a conformance test page or an example page), it cannot be included in the scope of conformance or in a conformance claim.q> The conformance requirements also state what is allowed in any optional <q>Conformance Claims,q> starting with: <q>Conformance is defined only for <a href="https://www.w3.org/TR/WCAG20/#webpagedef">Web pagesa>. However, a conformance claim may be made to cover one page, a series of pages, or multiple related Web pages.q> For the purposes of this document, we use the term <q>WCAG 2.x conformance modelq> to refer to the normative text in the <a href="https://www.w3.org/TR/WCAG20/#conformance">Conformance sectiona> of WCAG 2.0 and WCAG 2.1.
98+
<p>Assessing conformance of such large, highly complex, dynamic sites to the <a href="https://www.w3.org/TR/WCAG20/">Web Content Accessibility Guidelines (WCAG) 2.0a> [[wcag20]] or <a href="https://www.w3.org/TR/WCAG21/">2.1a> [[wcag21]] has proved difficult. The <a href="https://www.w3.org/TR/WCAG20/#conformance">Web Content Accessibility Guidelines 2.0 include a set of normative requirementsa> <q>in order for a web page to conform to WCAG 2.0,q> including that conformance <q>is for full web page(s) only, and cannot be achieved if part of a web page is excluded,q> along with a Note that states <q>If a page cannot conform (for example, a conformance test page or an example page), it cannot be included in the scope of conformance or in a conformance claim.q> The conformance requirements also state what is allowed in any optional <q>Conformance Claims,q> starting with: <q>Conformance is defined only for <a href="https://www.w3.org/TR/WCAG20/#webpagedef">web pagesa>. However, a conformance claim may be made to cover one page, a series of pages, or multiple related web pages.q> For the purposes of this document, we use the term <q>WCAG 2.x conformance modelq> to refer to the normative text in the <a href="https://www.w3.org/TR/WCAG20/#conformance">Conformance sectiona> of WCAG 2.0 and WCAG 2.1.
9999
p>
100100

101101
<p>This WCAG 2.x conformance model contains a mitigation related to partial conformance for 3rd party content (see <a href="#Challenge-3.1">Sec. 3.1: Treatment of 3rd party content and Statements of Partial Conformancea> below). Further in recognition of these challenges, the W3C Note <a href="http://www.w3.org/tr/wcag-em/">Website Accessibility Conformance Evaluation Methodology (WCAG-EM) 1.0a> [[wcag-em]] was published in 2014 to provide <q>guidance on evaluating how well websites conform to the Web Content Accessibility Guidelines.q> This W3C document <q>describes a procedure to evaluate websites and includes considerations to guide evaluators and to promote good practice,q> which can help organizations to make a conformance claim, while acknowledging that there may be errors on pages not in the sample set or that were not picked up by automated evaluation tools on pages that were not in the human evaluation sample. While WCAG-EM provides a practical method for claiming conformance for a website, it doesn't fully address the challenges in making every part of every page in a large, dynamic website conform to every success criterion.
@@ -211,7 +211,7 @@

Additional Background

211211
<li>Any additional challenges, or further illustration of challenges in the existing identified areas below;li>
212212
<li>Contributions to the mitigation approaches, and questions or concerns about the mitigation approaches;li>
213213
ul>
214-
<p>We seek to gain a thorough understanding of the challenges faced by large, complex, and dynamic websites who are attempting to provide accessible services to their web site users. It is expected that a more thorough understanding of these challenges can lead to either a new conformance model, or an alternative model that is more appropriate for large, complex, and/or dynamic websites (in <a href="https://www.w3.org/WAI/wcag3">WCAG 3.0a>).p>
214+
<p>We seek to gain a thorough understanding of the challenges faced by large, complex, and dynamic websites who are attempting to provide accessible services to their website users. It is expected that a more thorough understanding of these challenges can lead to either a new conformance model, or an alternative model that is more appropriate for large, complex, and/or dynamic websites (in <a href="https://www.w3.org/WAI/wcag3">WCAG 3.0a>).p>
215215

216216
<p class="silver">This document also includes previously published research from the Silver Task Force and Community Group that is related to Challenges with Accessibility Guidelines Conformance and Testing. There is some overlap between the challenges captured in this published research and the challenges enumerated in the first 4 sections of this document. The research findings have been folded into other sections of this document as appropriate.p>
217217

@@ -291,7 +291,7 @@

Mitigations

291291
section>
292292
<section id="Challenge-3">
293293
<h2>Challenge #3: 3rd party contenth2>
294-
<p>Very large, highly dynamic web sites generally aggregate content provided by multiple entities. Many of these are third parties with the ability to add content directly to the website—including potentially every website visitor. The relationship to the 3rd party can be that of a user, a customer, or a professional provider of content such as an advertiser. While the website can provide guidance on how to post content so that it meets accessibility guidance, it is ultimately up to those third parties to understand and correctly implement that guidance. Constraints on page templates and editing facilities can greatly help minimize accessibility issues but, even with automated checks prior to accepting the post, some Success Criteria require human assessment.p>
294+
<p>Very large, highly dynamic websites generally aggregate content provided by multiple entities. Many of these are third parties with the ability to add content directly to the website—including potentially every website visitor. The relationship to the 3rd party can be that of a user, a customer, or a professional provider of content such as an advertiser. While the website can provide guidance on how to post content so that it meets accessibility guidance, it is ultimately up to those third parties to understand and correctly implement that guidance. Constraints on page templates and editing facilities can greatly help minimize accessibility issues but, even with automated checks prior to accepting the post, some Success Criteria require human assessment.p>
295295
<p>Copyright, commercial agreements, and similar constraints that restrict the ability to modify or impose requirements on third party content can also make full conformance claims infeasible.p>
296296
<section id="Challenge-3.1">
297297
<h3>Treatment of 3rd party content and Statements of Partial Conformanceh3>
@@ -462,7 +462,7 @@

Silver Research Findings

462462
<section class="mitigation">
463463
<h3>Mitigationsh3>
464464

465-
<p>We know of no useable mitigations to achieve the <q>Accessibility Supportedq> conformance requirement for public facing web sites. <a href="https://www.w3.org/TR/WCAG-EM/#step1c">WCAG-EM's Second Notea> suggests that: <q>For some websites in closed networks, such as an intranet website, where both the users and the computers used to access the website are known, this baseline may be limited to the operating systems, web browsers and assistive
465+
<p>We know of no useable mitigations to achieve the <q>Accessibility Supportedq> conformance requirement for public facing websites. <a href="https://www.w3.org/TR/WCAG-EM/#step1c">WCAG-EM's Second Notea> suggests that: <q>For some websites in closed networks, such as an intranet website, where both the users and the computers used to access the website are known, this baseline may be limited to the operating systems, web browsers and assistive
466466
technologies used within this closed network.q> It continues saying: <q>However, in most cases this baseline is ideally broader to cover the majority of current user agents used by people with disabilities in any applicable particular geographic region and
467467
language community.q> Beyond placing the responsibility on the evaluator to establish this baseline, <a href="https://www.w3.org/TR/UNDERSTANDING-WCAG20/conformance.html#uc-accessibility-support-head">Note 5 in Understanding Conformance 2.0a> suggests that: <q>One way for authors to locate uses of a technology that are accessibility supported would be to consult compilations of uses that are documented to be accessibility supported. … Authors, companies, technology vendors, or others may document accessibility-supported ways of using Web content technologies.q> Unfortunately, we know of no such public repository.
468468
p>
@@ -1159,7 +1159,7 @@

Silver Research Problem Statements

11591159
<li>Constraints on <q>What is Strictly Testableq> provides an obstacle to including guidance that meets the needs of people with disabilities but is not conducive to a pass/fail test.li>
11601160
<li>Human Testable (related to Ambiguity) also relates to differences in knowledge and priorities of different testers achieve different results.li>
11611161
<li>Accessibility Supported is a conformance requirement of WCAG 2 that is poorly understood and incompletely implemented.li>
1162-
<li>Evolving Technology of the rapidly changing web must constantly be evaluated against the capabilities of assistive technology and evolving assistive technology must be evaluated against the backward compatibility of existing web sites.li>
1162+
<li>Evolving Technology of the rapidly changing web must constantly be evaluated against the capabilities of assistive technology and evolving assistive technology must be evaluated against the backward compatibility of existing websites.li>
11631163
ul>
11641164
section>
11651165
<section>

techniques/aria/ARIA8.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,7 +1,7 @@
11
><html lang="en" xml:lang="en" xmlns="http://www.w3.org/1999/xhtml"><head><title>Using aria-label for link purposetitle><link rel="stylesheet" type="text/css" href="../../css/editors.css" class="remove"/>head><body><h1>Using aria-label for link purposeh1><section class="meta"><p class="id">ID: ARIA8p><p class="technology">Technology: ariap><p class="type">Type: Techniquep>section><section id="applicability"><h2>When to Useh2>
22
<p>Technologies that support <a href="https://www.w3.org/TR/wai-aria/">Accessible Rich Internet Applications (WAI-ARIA)a>. p>
33
section><section id="description"><h2>Descriptionh2>
4-
<p>The objective of this technique is to describe the purpose of a link using the <code class="language-html">aria-labelcode> attribute. The <code class="language-html">aria-labelcode> attribute provides a way to place a descriptive text label on an object, such as a link, when there are no elements visible on the page that describe the object. If descriptive elements are visible on the page, the <code class="language-html">aria-labelledbycode> attribute should be used instead of <code class="language-html">aria-labelcode>. Providing a descriptive text label lets a user distinguish the link from links in the Web page that lead to other destinations and helps the user determine whether to follow the link. In some assistive technologies the <code class="language-html">aria-labelcode> value will show in the list of links instead of the actual link text.p>
4+
<p>The objective of this technique is to describe the purpose of a link using the <code class="language-html">aria-labelcode> attribute. The <code class="language-html">aria-labelcode> attribute provides a way to place a descriptive text label on an object, such as a link, when there are no elements visible on the page that describe the object. If descriptive elements are visible on the page, the <code class="language-html">aria-labelledbycode> attribute should be used instead of <code class="language-html">aria-labelcode>. Providing a descriptive text label lets a user distinguish the link from links in the web page that lead to other destinations and helps the user determine whether to follow the link. In some assistive technologies the <code class="language-html">aria-labelcode> value will show in the list of links instead of the actual link text.p>
55
<p>Per the <a href="https://www.w3.org/TR/accname/">Accessible Name and Description Computationa> and the <a href="https://www.w3.org/TR/html-aam-1.0/#accessible-name-and-description-computation">Accessible Name and Description Computationa> in the HTML Accessibility API Mappings 1.0, the <code class="language-html">aria-labelcode> text will override the text supplied within the link. As such the text supplied will be used instead of the link text by assistive technology. Due to this it is recommended to start the text used in <code class="language-html">aria-labelcode> with the text used within the link. This will allow consistent communication between users.p>
66
section><section id="examples"><h2>Examplesh2>
77
<section class="example">

techniques/client-side-script/SCR1.html

Lines changed: 2 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -22,7 +22,7 @@

Description

2222
<section id="examples">
2323
<h2>Examplesh2>
2424
<ul>
25-
<li>A Web page contains current stock market statistics and is set to refresh periodically. When the user is warned prior to refreshing the first time, the user is provided with an option to extend the time period between refreshes.li>
25+
<li>A web page contains current stock market statistics and is set to refresh periodically. When the user is warned prior to refreshing the first time, the user is provided with an option to extend the time period between refreshes.li>
2626
<li>In an online chess game, each player is given a time limit for completing each move. When the player is warned that time is almost up for this move, the user is provided with an option to increase the time.li>
2727
ul>
2828
section>
@@ -31,7 +31,7 @@

Tests

3131
<section class="procedure">
3232
<h3>Procedureh3>
3333
<ol>
34-
<li>On a Web page that uses scripts to enforce a time limit, wait until the time limit has expired.li>
34+
<li>On a web page that uses scripts to enforce a time limit, wait until the time limit has expired.li>
3535
<li>Determine if an option was provided to extend the time limit.li>
3636
ol>
3737
section>

techniques/client-side-script/SCR14.html

Lines changed: 3 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -88,16 +88,16 @@

The HTML

8888
section>
8989
section><section id="tests"><h2>Testsh2>
9090
<section class="procedure"><h3>Procedureh3>
91-
<p>For a Web page that supports non-emergency interruptions:p>
91+
<p>For a web page that supports non-emergency interruptions:p>
9292
<ol>
93-
<li>Load the Web page and verify that no non-emergency alerts are displayed.li>
93+
<li>Load the web page and verify that no non-emergency alerts are displayed.li>
9494
<li>Verify there is a mechanism to activate and deactivate the non-emergency interruptions.li>
9595
ol>
9696
section>
9797
<section class="results">
9898
<h3>Expected Resultsh3>
9999
<ul>
100-
<li>For a Web page that supports non-emergency interruptions, checks #1 and #2 are true.li>
100+
<li>For a web page that supports non-emergency interruptions, checks #1 and #2 are true.li>
101101
ul>
102102
section>
103103
section>

techniques/client-side-script/SCR16.html

Lines changed: 1 addition & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -66,7 +66,7 @@

Examples

6666
<section id="tests">
6767
<h2>Testsh2>
6868
<section class="procedure"><h3>Procedureh3>
69-
<p>On a Web page that has a time limit controlled by a script:p>
69+
<p>On a web page that has a time limit controlled by a script:p>
7070
<ol>
7171
<li>Load the page and start a timer that is 20 seconds less than the time limit.li>
7272
<li>When the timer expires, check that a confirmation dialog is displayed warning of the impending time limit.li>

0 commit comments

Comments
 (0)