Skip to content

Commit 795a9bc

Browse files
alastcalastc
authored
Merge pull request #3296 from w3c/patrickhlauke-reformat-old-understanding
Reformat definition lists, ordered lists, fix Reading Level understanding
2 parents 3698095 + 75d4b91 commit 795a9bc

67 files changed

Lines changed: 721 additions & 2391 deletions

File tree

Some content is hidden

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

‎understanding/20/abbreviations.html‎

Lines changed: 19 additions & 77 deletions
Original file line numberDiff line numberDiff line change
@@ -90,85 +90,31 @@ <h2>Benefits of Abbreviations</h2>
9090
<section id="examples">
9191
<h2>Examples of Abbreviations</h2>
9292

93-
94-
<ul>
95-
96-
<li>
97-
98-
<p>
99-
100-
<strong>An abbreviation whose expansion is provided the first time the abbreviation appears
101-
in the content.
102-
</strong>
103-
104-
</p>
105-
106-
<p>The name, "World Wide Web Consortium," appears as the first heading on the organization's
107-
home page. The abbreviation, "W3C," is enclosed in parentheses in the same heading.
108-
109-
</p>
110-
111-
</li>
112-
113-
<li>
114-
115-
<p>
116-
117-
<strong>A dictionary search form.</strong>
118-
119-
</p>
120-
121-
<p>A Web site includes a search form provided by an on-line acronym service. Users enter
93+
<dl>
94+
<dt>An abbreviation whose expansion is provided the first time the abbreviation appears
95+
in the content</dt>
96+
<dd>The name, "World Wide Web Consortium," appears as the first heading on the organization's
97+
home page. The abbreviation, "W3C," is enclosed in parentheses in the same heading.</dd>
98+
<dt>A dictionary search form</dt>
99+
<dd>A Web site includes a search form provided by an on-line acronym service. Users enter
122100
an acronym and the form returns a list of possible expansions from the sources that
123-
it searched.
124-
</p>
125-
126-
</li>
127-
128-
<li>
129-
130-
<p>
131-
132-
<strong>A medical Web site.</strong>
133-
134-
</p>
135-
136-
<p>A medical Web site provides information for both doctors and patients. The site includes
101+
it searched.</dd>
102+
<dt>A medical Web site</dt>
103+
<dd>A medical Web site provides information for both doctors and patients. The site includes
137104
a set of cascading dictionaries; a very specialized medical dictionary is first,
138105
followed by a second medical dictionary for the general public. The cascade also includes
139106
a list of acronyms and abbreviations that are unique to the site, and finally there
140107
is a standard dictionary as well. The standard dictionary at the end of the list provides
141108
definitions for most words in the text. The specialized medical dictionary yields
142109
definitions of unusual medical terms. Definitions for words that appear in more than
143110
one dictionary are listed in the order of the cascade. The meaning of acronyms and
144-
abbreviations is provided by the list of acronyms and abbreviations.
145-
</p>
146-
147-
</li>
148-
149-
<li>
150-
151-
<p>
152-
153-
<strong>
154-
Expanded forms of Abbreviations.
155-
156-
</strong>
157-
158-
</p>
159-
160-
<p>
161-
The expanded form of each abbreviation is available in a programmatically determinable
111+
abbreviations is provided by the list of acronyms and abbreviations.</dd>
112+
<dt>Expanded forms of Abbreviations</dt>
113+
<dd>The expanded form of each abbreviation is available in a programmatically determinable
162114
manner. User agents that speak the text can use the expanded form to announce the
163115
abbreviation. Other user agents might make the expanded form available as a tooltip
164-
or as contextual help for the abbreviation.
165-
166-
167-
</p>
168-
169-
</li>
170-
171-
</ul>
116+
or as contextual help for the abbreviation.</dd>
117+
</dl>
172118

173119
</section>
174120

@@ -208,7 +154,7 @@ <h4>Situation A: If the abbreviation has only one meaning within the Web page:
208154

209155
</h4>
210156

211-
<ol>
157+
<ul>
212158

213159
<li>
214160

@@ -222,15 +168,11 @@ <h4>Situation A: If the abbreviation has only one meaning within the Web page:
222168
<ul>
223169

224170
<li>
225-
226171
<a href="https://www.w3.org/WAI/WCAG21/Techniques/general/G97" class="general">Providing the abbreviation immediately following the expanded form</a>
227-
228172
</li>
229173

230174
<li>
231-
232175
<a href="https://www.w3.org/WAI/WCAG21/Techniques/general/G55" class="general">Linking to definitions</a>
233-
234176
</li>
235177

236178
<li>
@@ -299,7 +241,7 @@ <h4>Situation A: If the abbreviation has only one meaning within the Web page:
299241

300242
</li>
301243

302-
</ol>
244+
</ul>
303245

304246
</section>
305247

@@ -309,7 +251,7 @@ <h4>Situation B: If the abbreviation means different things within the same Web
309251

310252
</h4>
311253

312-
<ol>
254+
<ul>
313255

314256
<li>
315257

@@ -344,7 +286,7 @@ <h4>Situation B: If the abbreviation means different things within the same Web
344286

345287
</li>
346288

347-
</ol>
289+
</ul>
348290

349291
</section>
350292

‎understanding/20/audio-control.html‎

Lines changed: 2 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -75,13 +75,10 @@ <h2>Benefits of Audio Control</h2>
7575
<section id="examples">
7676
<h2>Examples of Audio Control</h2>
7777

78-
7978
<ul>
80-
8179
<li>An audio file begins playing automatically when a page is opened. However, the audio
8280
can be stopped by the user by selecting a "silent" link at the top of the page.
8381
</li>
84-
8582
</ul>
8683

8784
</section>
@@ -100,7 +97,7 @@ <h2>Techniques for Audio Control</h2>
10097
<h3>Sufficient Techniques for Audio Control</h3>
10198

10299

103-
<ol>
100+
<ul>
104101

105102
<li>
106103

@@ -120,7 +117,7 @@ <h3>Sufficient Techniques for Audio Control</h3>
120117

121118
</li>
122119

123-
</ol>
120+
</ul>
124121

125122
</section>
126123

‎understanding/20/audio-description-or-media-alternative-prerecorded.html‎

Lines changed: 12 additions & 40 deletions
Original file line numberDiff line numberDiff line change
@@ -104,69 +104,41 @@ <h2>Benefits of Audio Description or Media Alternative (Prerecorded)</h2>
104104

105105
<section id="examples">
106106
<h2>Examples of Audio Description or Media Alternative (Prerecorded)</h2>
107-
108-
109-
<ul>
110-
111-
<li>
112-
107+
108+
<dl>
109+
<dt>A movie with audio description</dt>
110+
<dd>
113111
<p>
114-
115-
<strong>A movie with audio description.</strong>
116-
117-
</p>
118-
119-
<p>
120-
121112
<strong>Describer: </strong>A title, "Teaching Evolution Case Studies. Bonnie Chen." A teacher shows photographs
122113
of birds with long, thin beaks.
123114
</p>
124115

125116
<p>
126-
127117
<strong>Bonnie Chen: </strong>"These photos were all taken at the Everglades."
128118
</p>
129119

130120
<p>
131-
132121
<strong>Describer: </strong>The teacher hands each student two flat, thin wooden sticks.
133122
</p>
134123

135124
<p>
136-
137125
<strong>Bonnie Chen: </strong>"Today you will pretend to be a species of wading bird that has a beak like this."
138126
</p>
139127

140128
<p>
141-
142129
<strong>Describer: </strong>The teacher holds two of the sticks to her mouth making the shape of a beak.
143130
</p>
144131

145-
<p>Transcript of audio based on the first few minutes of "
146-
<a href="http://www.pbs.org/wgbh/evolution/educators/teachstuds/tvideos.html">Teaching Evolution Case Studies, Bonnie Chen</a>" (copyright WGBH and Clear Blue Sky Productions, Inc.)
147-
</p>
148-
149-
</li>
150-
151-
<li>
152-
153-
<p>
154-
155-
<strong>An alternative for time-based media for a training video</strong>
156-
157-
</p>
158-
159-
<p>A company purchases a Training video for use by its employees and puts it on the companies
132+
<p>Transcript of audio based on the first few minutes of "<a href="https://www.pbs.org/wgbh/evolution/educators/teachstuds/tvideos.html">Teaching Evolution Case Studies, Bonnie Chen</a>" (copyright WGBH and Clear Blue Sky Productions, Inc.)</p>
133+
</dd>
134+
<dt>An alternative for time-based media for a training video</dt>
135+
<dd>A company purchases a Training video for use by its employees and puts it on the companies
160136
intranet. The video involves explaining use of a new technology and has a person talking
161137
and showing things at the same time. Since there is no place to insert audio description
162138
of the visual demonstrations during gaps in dialogue, the company provides an alternative
163139
for time-based media that all employees, including those who cannot see the demonstrations,
164-
can use to better understand what is being presented.
165-
</p>
166-
167-
</li>
168-
169-
</ul>
140+
can use to better understand what is being presented.</dd>
141+
</dl>
170142

171143
</section>
172144

@@ -218,7 +190,7 @@ <h2>Techniques for Audio Description or Media Alternative (Prerecorded)</h2>
218190
<h3>Sufficient Techniques for Audio Description or Media Alternative (Prerecorded)</h3>
219191

220192

221-
<ol>
193+
<ul>
222194

223195
<li>
224196

@@ -323,7 +295,7 @@ <h3>Sufficient Techniques for Audio Description or Media Alternative (Prerecorde
323295

324296
</li>
325297

326-
</ol>
298+
</ul>
327299

328300
</section>
329301

‎understanding/20/audio-description-prerecorded.html‎

Lines changed: 8 additions & 21 deletions
Original file line numberDiff line numberDiff line change
@@ -76,19 +76,10 @@ <h2>Benefits of Audio Description (Prerecorded)</h2>
7676
<section id="examples">
7777
<h2>Examples of Audio Description (Prerecorded)</h2>
7878

79-
80-
<ul>
81-
82-
<li>
83-
79+
<dl>
80+
<dt>A movie with audio description</dt>
81+
<dd>
8482
<p>
85-
86-
<strong>A movie with audio description.</strong>
87-
88-
</p>
89-
90-
<p>
91-
9283
<strong>Describer: </strong>A title, "Teaching Evolution Case Studies. Bonnie Chen." A teacher shows photographs
9384
of birds with long, thin beaks.
9485
</p>
@@ -113,13 +104,9 @@ <h2>Examples of Audio Description (Prerecorded)</h2>
113104
<strong>Describer: </strong>The teacher holds two of the sticks to her mouth making the shape of a beak.
114105
</p>
115106

116-
<p>Transcript of audio based on the first few minutes of "
117-
<a href="http://www.pbs.org/wgbh/evolution/educators/teachstuds/tvideos.html">Teaching Evolution Case Studies, Bonnie Chen</a>" (copyright WGBH and Clear Blue Sky Productions, Inc.)
118-
</p>
119-
120-
</li>
121-
122-
</ul>
107+
<p>Transcript of audio based on the first few minutes of "<a href="http://www.pbs.org/wgbh/evolution/educators/teachstuds/tvideos.html">Teaching Evolution Case Studies, Bonnie Chen</a>" (copyright WGBH and Clear Blue Sky Productions, Inc.)</p>
108+
</dd>
109+
</dl>
123110

124111
</section>
125112

@@ -171,7 +158,7 @@ <h2>Techniques for Audio Description (Prerecorded)</h2>
171158
<h3>Sufficient Techniques for Audio Description (Prerecorded)</h3>
172159

173160

174-
<ol>
161+
<ul>
175162

176163
<li>
177164

@@ -239,7 +226,7 @@ <h3>Sufficient Techniques for Audio Description (Prerecorded)</h3>
239226

240227
</li>
241228

242-
</ol>
229+
</ul>
243230

244231
</section>
245232

0 commit comments

Comments
 (0)