Skip to content

Commit 642d752

Browse files
daniel-montalvopkra
daniel-montalvo
and
pkra
authored
Remove TR uris for aria practices guide and make some prose adjustments (#2646)
Co-authored-by: Peter Krautzberger <[email protected]>
1 parent 88d563e commit 642d752

File tree

11 files changed

+25
-105
lines changed

11 files changed

+25
-105
lines changed

‎accname/index.html‎

Lines changed: 0 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -129,13 +129,6 @@
129129
WD: "https://www.w3.org/TR/html-aam/",
130130
REC: "https://www.w3.org/TR/html-aam/",
131131
},
132-
practicesURLs: {
133-
ED: "https://www.w3.org/WAI/ARIA/apg/",
134-
WD: "https://www.w3.org/WAI/ARIA/apg/",
135-
FPWD: "https://www.w3.org/WAI/ARIA/apg/",
136-
CR: "https://www.w3.org/WAI/ARIA/apg/",
137-
REC: "https://www.w3.org/WAI/ARIA/apg/",
138-
},
139132
preProcess: [linkCrossReferences, getParticipants],
140133
postProcess: [addPlatformMaintainers],
141134
//Pointing to the 1.2 versions but should remove the version in the publishing branch

‎core-aam/index.html‎

Lines changed: 2 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -162,13 +162,6 @@
162162
WD: "https://www.w3.org/TR/html-aam/",
163163
REC: "https://www.w3.org/TR/html-aam/",
164164
},
165-
practicesURLs: {
166-
ED: "https://www.w3.org/WAI/ARIA/apg/",
167-
WD: "https://www.w3.org/WAI/ARIA/apg/",
168-
FPWD: "https://www.w3.org/WAI/ARIA/apg/",
169-
CR: "https://www.w3.org/WAI/ARIA/apg/",
170-
REC: "https://www.w3.org/WAI/ARIA/apg/",
171-
},
172165

173166
preProcess: [linkCrossReferences, getParticipants],
174167
postProcess: [addPlatformMaintainers],
@@ -218,9 +211,8 @@ <h2>Introduction</h2>
218211
</li>
219212
<li>
220213
<cite
221-
><a href="http://www.w3.org/TR/wai-aria-practices/"><abbr title="Accessible Rich Internet Applications">WAI-ARIA</abbr> Authoring Practices Guide</a></cite
222-
>
223-
[[WAI-ARIA-PRACTICES-1.2]], describes how web content developers can develop accessible rich internet applications using <abbr title="Accessible Rich Internet Applications">WAI-ARIA</abbr>.
214+
><a href="https://www.w3.org/WAI/ARIA/apg/"><abbr title="Accessible Rich Internet Applications">WAI-ARIA</abbr> Authoring Practices Guide</a></cite
215+
>, describes how web content developers can develop accessible rich internet applications using <abbr title="Accessible Rich Internet Applications">WAI-ARIA</abbr>.
224216
It provides detailed advice and examples directed primarily to web application developers, yet also useful to user agent and developers of assistive technologies.
225217
</li>
226218
<li>

‎dpub-aam/index.html‎

Lines changed: 0 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -137,13 +137,6 @@
137137
WD: "https://www.w3.org/TR/html-aam/",
138138
REC: "https://www.w3.org/TR/html-aam/",
139139
},
140-
practicesURLs: {
141-
ED: "https://www.w3.org/WAI/ARIA/apg/",
142-
WD: "https://www.w3.org/WAI/ARIA/apg/",
143-
FPWD: "https://www.w3.org/WAI/ARIA/apg/",
144-
CR: "https://www.w3.org/WAI/ARIA/apg/",
145-
REC: "https://www.w3.org/WAI/ARIA/apg/",
146-
},
147140
accNameURLs: {
148141
ED: "https://w3c.github.io/accname/",
149142
WD: "https://www.w3.org/TR/accname-1.2/",

‎dpub-aria/index.html‎

Lines changed: 0 additions & 9 deletions
Original file line numberDiff line numberDiff line change
@@ -125,15 +125,6 @@
125125
PR: "https://www.w3.org/TR/html-aam/",
126126
REC: "https://www.w3.org/TR/html-aam/",
127127
},
128-
practicesURLs: {
129-
ED: "https://www.w3.org/WAI/ARIA/apg/",
130-
WD: "https://www.w3.org/WAI/ARIA/apg/",
131-
FPWD: "https://www.w3.org/WAI/ARIA/apg/",
132-
WD: "https://www.w3.org/WAI/ARIA/apg/",
133-
CR: "https://www.w3.org/WAI/ARIA/apg/",
134-
PR: "https://www.w3.org/WAI/ARIA/apg/",
135-
REC: "https://www.w3.org/WAI/ARIA/apg/",
136-
},
137128
preProcess: [linkCrossReferences, getParticipants],
138129
postProcess: [ariaAttributeReferences],
139130
definitionMap: [],

‎graphics-aam/index.html‎

Lines changed: 2 additions & 10 deletions
Original file line numberDiff line numberDiff line change
@@ -168,13 +168,6 @@
168168
WD: "https://www.w3.org/TR/html-aam/",
169169
REC: "https://www.w3.org/TR/html-aam/",
170170
},
171-
practicesURLs: {
172-
ED: "https://www.w3.org/WAI/ARIA/apg/",
173-
WD: "https://www.w3.org/WAI/ARIA/apg/",
174-
FPWD: "https://www.w3.org/WAI/ARIA/apg/",
175-
CR: "https://www.w3.org/WAI/ARIA/apg/",
176-
REC: "https://www.w3.org/WAI/ARIA/apg/",
177-
},
178171

179172
preProcess: [linkCrossReferences, getParticipants],
180173
postProcess: [],
@@ -269,9 +262,8 @@ <h2>Introduction</h2>
269262
</li>
270263
<li>
271264
<cite
272-
><a href="https://www.w3.org/TR/wai-aria-practices/"><abbr title="Accessible Rich Internet Applications">WAI-ARIA</abbr> Authoring Practices Guide</a></cite
273-
>
274-
[[WAI-ARIA-PRACTICES-1.1]], a planned W3C Working Group Note, which describes how web content developers can develop accessible rich internet applications using
265+
><a href="https://www.w3.org/WAI/ARIA/apg/"><abbr title="Accessible Rich Internet Applications">WAI-ARIA</abbr> Authoring Practices Guide</a></cite
266+
>, a WAI resource that describes how web content developers can develop accessible rich internet applications using
275267
<abbr title="Accessible Rich Internet Applications">WAI-ARIA</abbr>. It provides detailed advice and examples directed primarily to web application developers, yet also useful to developers
276268
of user agents and assistive technologies.
277269
</li>

‎graphics-aria/index.html‎

Lines changed: 0 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -186,13 +186,6 @@
186186
WD: "https://www.w3.org/TR/html-aam/",
187187
REC: "https://www.w3.org/TR/html-aam/",
188188
},
189-
practicesURLs: {
190-
ED: "https://www.w3.org/WAI/ARIA/apg/",
191-
WD: "https://www.w3.org/WAI/ARIA/apg/",
192-
FPWD: "https://www.w3.org/WAI/ARIA/apg/",
193-
CR: "https://www.w3.org/WAI/ARIA/apg/",
194-
REC: "https://www.w3.org/WAI/ARIA/apg/",
195-
},
196189

197190
preProcess: [linkCrossReferences, getParticipants],
198191
postProcess: [ariaAttributeReferences],

‎html-aam/index.html‎

Lines changed: 0 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -96,13 +96,6 @@
9696
WD: "https://www.w3.org/TR/html-aam/",
9797
REC: "https://www.w3.org/TR/html-aam/",
9898
},
99-
practicesURLs: {
100-
ED: "https://www.w3.org/WAI/ARIA/apg/",
101-
WD: "https://www.w3.org/WAI/ARIA/apg/",
102-
FPWD: "https://www.w3.org/WAI/ARIA/apg/",
103-
CR: "https://www.w3.org/WAI/ARIA/apg/",
104-
REC: "https://www.w3.org/WAI/ARIA/apg/",
105-
},
10699

107100
xref: ["HTML", "core-aam", "accname", "wai-aria", "dom", "infra"],
108101
preProcess: [linkCrossReferences, getParticipants],

‎index.html‎

Lines changed: 19 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -169,13 +169,6 @@
169169
WD: "https://www.w3.org/TR/html-aam/",
170170
REC: "https://www.w3.org/TR/html-aam/",
171171
},
172-
practicesURLs: {
173-
ED: "https://www.w3.org/WAI/ARIA/apg/",
174-
WD: "https://www.w3.org/WAI/ARIA/apg/",
175-
FPWD: "https://www.w3.org/WAI/ARIA/apg/",
176-
CR: "https://www.w3.org/WAI/ARIA/apg/",
177-
REC: "https://www.w3.org/WAI/ARIA/apg/",
178-
},
179172

180173
preProcess: [linkCrossReferences, getParticipants],
181174
postProcess: [ariaAttributeReferences],
@@ -236,16 +229,16 @@ <h1>Introduction</h1>
236229
creating custom widgets and other web application components. Please see the <a href="https://www.w3.org/WAI/standards-guidelines/aria/">WAI-ARIA Overview</a> for links to related documents
237230
for other audiences, such as
238231
<cite
239-
><a href="" class="practices"><abbr title="Accessible Rich Internet Applications">ARIA</abbr> Authoring Practices Guide</a></cite
232+
><a href="https://www.w3.org/WAI/ARIA/apg/"><abbr title="Accessible Rich Internet Applications">ARIA</abbr> Authoring Practices Guide</a></cite
240233
>
241-
[[WAI-ARIA-PRACTICES-1.2]] that introduces developers to the accessibility problems that WAI-ARIA is intended to solve, the fundamental concepts, and the technical approach of WAI-ARIA.
234+
that introduces developers to the accessibility problems that WAI-ARIA is intended to solve, the fundamental concepts, and the technical approach of WAI-ARIA.
242235
</p>
243236
<p>
244237
This document currently handles two aspects of <a>roles</a>: user interface functionality and structural <a>relationships</a>. For more information and use cases, see
245238
<cite
246-
><a href="" class="practices"><abbr title="Accessible Rich Internet Applications">ARIA</abbr> Authoring Practices Guide</a></cite
239+
><a href="https://www.w3.org/WAI/ARIA/apg/"><abbr title="Accessible Rich Internet Applications">ARIA</abbr> Authoring Practices Guide</a></cite
247240
>
248-
[[WAI-ARIA-PRACTICES-1.2]] for the use of roles in making interactive content accessible.
241+
for the use of roles in making interactive content accessible.
249242
</p>
250243
<p>
251244
Roles defined by this specification are designed to support the roles used by platform <a>accessibility <abbr title="Application Programming Interfaces">APIs</abbr></a
@@ -329,14 +322,14 @@ <h2>Rich Internet Application Accessibility</h2>
329322
<p>
330323
For more information see
331324
<cite
332-
><a href="" class="practices"><abbr title="Accessible Rich Internet Applications">ARIA</abbr> Authoring Practices Guide</a></cite
325+
><a href="https://www.w3.org/WAI/ARIA/apg/"><abbr title="Accessible Rich Internet Applications">ARIA</abbr> Authoring Practices Guide</a></cite
333326
>
334327
for the use of roles in making interactive content accessible.
335328
</p>
336329
<p>
337330
Users of alternate input devices need <a>keyboard accessible</a> content. The new semantics, when combined with the recommended keyboard interactions provided in
338331
<cite
339-
><a href="" class="practices"><abbr title="Accessible Rich Internet Applications">ARIA</abbr> Authoring Practices Guide</a></cite
332+
><a href="https://www.w3.org/WAI/ARIA/apg/"><abbr title="Accessible Rich Internet Applications">ARIA</abbr> Authoring Practices Guide</a></cite
340333
>, will allow alternate input solutions to facilitate command and control via an alternate input solution.
341334
</p>
342335
<p>
@@ -383,7 +376,9 @@ <h2>Target Audience</h2>
383376
following documents provide important supporting information:
384377
</p>
385378
<ul>
386-
<li>[[[WAI-ARIA-PRACTICES-1.2]]] addresses authoring recommendations for HTML, and is also of interest to developers of authoring tools and conformance checkers.</li>
379+
<li><cite><a href="https://www.w3.org/WAI/ARIA/apg/"><abbr title="Accessible Rich Internet Applications">ARIA</abbr>
380+
Authoring Practices Guide</a></cite>
381+
addresses authoring recommendations for HTML, and is also of interest to developers of authoring tools and conformance checkers.</li>
387382
<li>[[[CORE-AAM-1.2]]] addresses developers of [=user agents=] and <a class="termref">assistive technologies</a>.</li>
388383
<li>[[[ACCNAME-1.2]]] also addresses developers of [=user agents=] and <a class="termref">assistive technologies</a>.</li>
389384
</ul>
@@ -851,7 +846,7 @@ <h1>Using <abbr title="Accessible Rich Internet Applications">WAI-ARIA</abbr></h
851846
Complex web applications become inaccessible when <a>assistive technologies</a> cannot determine the <a>semantics</a> behind portions of a document or when the user is unable to effectively
852847
navigate to all parts of it in a usable way (see
853848
<cite
854-
><a href="" class="practices"><abbr title="Accessible Rich Internet Applications">ARIA</abbr> Authoring Practices Guide</a></cite
849+
><a href="https://www.w3.org/WAI/ARIA/apg/"><abbr title="Accessible Rich Internet Applications">ARIA</abbr> Authoring Practices Guide</a></cite
855850
>). <abbr title="Accessible Rich Internet Applications">WAI-ARIA</abbr> divides the semantics into <a>roles</a> (the type defining a user interface element) and <a>states</a> and
856851
[=ARIA/properties=] supported by the roles.
857852
</p>
@@ -1001,7 +996,7 @@ <h3>Information for Authors</h3>
1001996
it has keyboard focus. The author cannot use <code>:<span class="css-selector">focus</span></code> to style the currently active descendant since the actual focus is on the container.
1002997
</p>
1003998
<p>
1004-
More information on managing focus can be found in the <a href="practices/keyboard-interface" class="practices">Developing a Keyboard Interface</a> section of the
999+
More information on managing focus can be found in the <a href="https://www.w3.org/WAI/ARIA/apg/keyboard-interface">Developing a Keyboard Interface</a> section of the
10051000
<cite><abbr title="Accessible Rich Internet Applications">WAI-ARIA</abbr> Authoring Practices</cite>.
10061001
</p>
10071002
</section>
@@ -2879,7 +2874,7 @@ <h2>Definition of Roles</h2>
28792874
<p>
28802875
The features and behaviors of combobox implementations vary widely. Consequently, there are many important authoring considerations. See the
28812876
<cite
2882-
><a href="" class="practices"><abbr title="Accessible Rich Internet Applications">ARIA</abbr> Authoring Practices Guide</a></cite
2877+
><a href="https://www.w3.org/WAI/ARIA/apg/"><abbr title="Accessible Rich Internet Applications">ARIA</abbr> Authoring Practices Guide</a></cite
28832878
>
28842879
for additional details on implementing combobox design patterns.
28852880
</p>
@@ -4078,7 +4073,7 @@ <h2>Definition of Roles</h2>
40784073
<p>
40794074
See the
40804075
<cite
4081-
><a href="" class="practices"><abbr title="Accessible Rich Internet Applications">ARIA</abbr> Authoring Practices Guide</a></cite
4076+
><a href="https://www.w3.org/WAI/ARIA/apg/"><abbr title="Accessible Rich Internet Applications">ARIA</abbr> Authoring Practices Guide</a></cite
40824077
>
40834078
for additional details on implementing a feed design pattern.
40844079
</p>
@@ -4533,7 +4528,7 @@ <h2>Definition of Roles</h2>
45334528
<p>
45344529
See the
45354530
<cite
4536-
><a href="" class="practices"><abbr title="Accessible Rich Internet Applications">ARIA</abbr> Authoring Practices Guide</a></cite
4531+
><a href="https://www.w3.org/WAI/ARIA/apg/"><abbr title="Accessible Rich Internet Applications">ARIA</abbr> Authoring Practices Guide</a></cite
45374532
>
45384533
for additional details on implementing grid design patterns.
45394534
</p>
@@ -10217,7 +10212,7 @@ <h5>Presentational Role Inheritance</h5>
1021710212
<a href="#managingfocus">Managing Focus</a>. <rref>tablist</rref> elements, which contain a set of associated <rref>tab</rref> elements, are typically placed near a series of
1021810213
<rref>tabpanel</rref> elements, usually preceding it. See the
1021910214
<cite
10220-
><a href="" class="practices"><abbr title="Accessible Rich Internet Applications">ARIA</abbr> Authoring Practices Guide</a></cite
10215+
><a href="https://www.w3.org/WAI/ARIA/apg/"><abbr title="Accessible Rich Internet Applications">ARIA</abbr> Authoring Practices Guide</a></cite
1022110216
>
1022210217
for details on implementing a tab set design pattern.
1022310218
</p>
@@ -10458,7 +10453,7 @@ <h5>Presentational Role Inheritance</h5>
1045810453
<p>
1045910454
<rref>tablist</rref> elements are typically placed near, and usually preceding, a series of <rref>tabpanel</rref> elements. See the
1046010455
<cite
10461-
><a href="" class="practices"><abbr title="Accessible Rich Internet Applications">ARIA</abbr> Authoring Practices Guide</a></cite
10456+
><a href="https://www.w3.org/WAI/ARIA/apg/""><abbr title="Accessible Rich Internet Applications">ARIA</abbr> Authoring Practices Guide</a></cite
1046210457
>
1046310458
for details on implementing a tab set design pattern.
1046410459
</p>
@@ -10564,7 +10559,7 @@ <h5>Presentational Role Inheritance</h5>
1056410559
<p>
1056510560
<rref>tablist</rref> elements are typically placed near, and usually preceding, a series of <rref>tabpanel</rref> elements. See the
1056610561
<cite
10567-
><a href="" class="practices"><abbr title="Accessible Rich Internet Applications">ARIA</abbr> Authoring Practices Guide</a></cite
10562+
><a href="https://www.w3.org/WAI/ARIA/apg/"><abbr title="Accessible Rich Internet Applications">ARIA</abbr> Authoring Practices Guide</a></cite
1056810563
>
1056910564
for details on implementing a tab set design pattern.
1057010565
</p>
@@ -12722,7 +12717,7 @@ <h2>Definitions of States and Properties (all aria-* attributes)</h2>
1272212717
<p>
1272312718
Examples using the <code>mixed</code> value of tri-state inputs are covered in the
1272412719
<cite
12725-
><a href="" class="practices"><abbr title="Accessible Rich Internet Applications">ARIA</abbr> Authoring Practices Guide</a></cite
12720+
><a href="https://www.w3.org/WAI/ARIA/apg/"><abbr title="Accessible Rich Internet Applications">ARIA</abbr> Authoring Practices Guide</a></cite
1272612721
>.
1272712722
</p>
1272812723
</div>
@@ -14267,7 +14262,7 @@ <h2>Definitions of States and Properties (all aria-* attributes)</h2>
1426714262
Authors SHOULD avoid implementing shortcut keys that inhibit operating system, user agent, or assistive technology functionality. This requires the author to carefully consider both
1426814263
which keys to assign and the contexts and conditions in which the keys are available to the user. For guidance, see the keyboard shortcuts section of the
1426914264
<cite
14270-
><a href="" class="practices"><abbr title="Accessible Rich Internet Applications">ARIA</abbr> Authoring Practices Guide</a></cite
14265+
><a href="https://www.w3.org/WAI/ARIA/apg/"><abbr title="Accessible Rich Internet Applications">ARIA</abbr> Authoring Practices Guide</a></cite
1427114266
>.
1427214267
</p>
1427314268
<p>

‎mathml-aam/index.html‎

Lines changed: 0 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -80,13 +80,6 @@
8080
WD: "https://www.w3.org/TR/html-aam/",
8181
REC: "https://www.w3.org/TR/html-aam/",
8282
},
83-
practicesURLs: {
84-
ED: "https://www.w3.org/WAI/ARIA/apg/",
85-
WD: "https://www.w3.org/WAI/ARIA/apg/",
86-
FPWD: "https://www.w3.org/WAI/ARIA/apg/",
87-
CR: "https://www.w3.org/WAI/ARIA/apg/",
88-
REC: "https://www.w3.org/WAI/ARIA/apg/",
89-
},
9083
preProcess: [linkCrossReferences, getParticipants],
9184
postProcess: [],
9285
definitionMap: [],

‎pdf-aam/index.html‎

Lines changed: 0 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -132,13 +132,6 @@
132132
WD: "https://www.w3.org/TR/html-aam/",
133133
REC: "https://www.w3.org/TR/html-aam/",
134134
},
135-
practicesURLs: {
136-
ED: "https://www.w3.org/WAI/ARIA/apg/",
137-
WD: "https://www.w3.org/WAI/ARIA/apg/",
138-
FPWD: "https://www.w3.org/WAI/ARIA/apg/",
139-
CR: "https://www.w3.org/WAI/ARIA/apg/",
140-
REC: "https://www.w3.org/WAI/ARIA/apg/",
141-
},
142135
preProcess: [linkCrossReferences, getParticipants],
143136
xref: ["HTML", "core-aam", "dom", "accname", "wai-aria", "infra"],
144137
};

0 commit comments

Comments
 (0)