Skip to content

Commit

Permalink
Merge pull request #3296 from w3c/patrickhlauke-reformat-old-understa…
Browse files Browse the repository at this point in the history 
…nding

Reformat definition lists, ordered lists, fix Reading Level understanding
  • Loading branch information
@alastc
alastc authored Aug 30, 2023
2 parents 3698095 + 75d4b91 commit 795a9bc
Show file tree
Hide file tree
Showing 67 changed files with 721 additions and 2,391 deletions.
96 changes: 19 additions & 77 deletions understanding/20/abbreviations.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -90,85 +90,31 @@ <h2>Benefits of Abbreviations</h2>
<section id="examples">
<h2>Examples of Abbreviations</h2>


<ul>

<li>

<p>

<strong>An abbreviation whose expansion is provided the first time the abbreviation appears
in the content.
</strong>

</p>

<p>The name, "World Wide Web Consortium," appears as the first heading on the organization's
home page. The abbreviation, "W3C," is enclosed in parentheses in the same heading.

</p>

</li>

<li>

<p>

<strong>A dictionary search form.</strong>

</p>

<p>A Web site includes a search form provided by an on-line acronym service. Users enter
<dl>
<dt>An abbreviation whose expansion is provided the first time the abbreviation appears
in the content</dt>
<dd>The name, "World Wide Web Consortium," appears as the first heading on the organization's
home page. The abbreviation, "W3C," is enclosed in parentheses in the same heading.</dd>
<dt>A dictionary search form</dt>
<dd>A Web site includes a search form provided by an on-line acronym service. Users enter
an acronym and the form returns a list of possible expansions from the sources that
it searched.
</p>

</li>

<li>

<p>

<strong>A medical Web site.</strong>

</p>

<p>A medical Web site provides information for both doctors and patients. The site includes
it searched.</dd>
<dt>A medical Web site</dt>
<dd>A medical Web site provides information for both doctors and patients. The site includes
a set of cascading dictionaries; a very specialized medical dictionary is first,
followed by a second medical dictionary for the general public. The cascade also includes
a list of acronyms and abbreviations that are unique to the site, and finally there
is a standard dictionary as well. The standard dictionary at the end of the list provides
definitions for most words in the text. The specialized medical dictionary yields
definitions of unusual medical terms. Definitions for words that appear in more than
one dictionary are listed in the order of the cascade. The meaning of acronyms and
abbreviations is provided by the list of acronyms and abbreviations.
</p>

</li>

<li>

<p>

<strong>
Expanded forms of Abbreviations.

</strong>

</p>

<p>
The expanded form of each abbreviation is available in a programmatically determinable
abbreviations is provided by the list of acronyms and abbreviations.</dd>
<dt>Expanded forms of Abbreviations</dt>
<dd>The expanded form of each abbreviation is available in a programmatically determinable
manner. User agents that speak the text can use the expanded form to announce the
abbreviation. Other user agents might make the expanded form available as a tooltip
or as contextual help for the abbreviation.


</p>

</li>

</ul>
or as contextual help for the abbreviation.</dd>
</dl>

</section>

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

</h4>

<ol>
<ul>

<li>

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

<li>

<a href="https://www.w3.org/WAI/WCAG21/Techniques/general/G97" class="general">Providing the abbreviation immediately following the expanded form</a>

</li>

<li>

<a href="https://www.w3.org/WAI/WCAG21/Techniques/general/G55" class="general">Linking to definitions</a>

</li>

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

</li>

</ol>
</ul>

</section>

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

</h4>

<ol>
<ul>

<li>

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

</li>

</ol>
</ul>

</section>

Expand Down
7 changes: 2 additions & 5 deletions understanding/20/audio-control.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -75,13 +75,10 @@ <h2>Benefits of Audio Control</h2>
<section id="examples">
<h2>Examples of Audio Control</h2>


<ul>

<li>An audio file begins playing automatically when a page is opened. However, the audio
can be stopped by the user by selecting a "silent" link at the top of the page.
</li>

</ul>

</section>
Expand All @@ -100,7 +97,7 @@ <h2>Techniques for Audio Control</h2>
<h3>Sufficient Techniques for Audio Control</h3>


<ol>
<ul>

<li>

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

</li>

</ol>
</ul>

</section>

Expand Down
52 changes: 12 additions & 40 deletions understanding/20/audio-description-or-media-alternative-prerecorded.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -104,69 +104,41 @@ <h2>Benefits of Audio Description or Media Alternative (Prerecorded)</h2>

<section id="examples">
<h2>Examples of Audio Description or Media Alternative (Prerecorded)</h2>


<ul>

<li>


<dl>
<dt>A movie with audio description</dt>
<dd>
<p>

<strong>A movie with audio description.</strong>

</p>

<p>

<strong>Describer: </strong>A title, "Teaching Evolution Case Studies. Bonnie Chen." A teacher shows photographs
of birds with long, thin beaks.
</p>

<p>

<strong>Bonnie Chen: </strong>"These photos were all taken at the Everglades."
</p>

<p>

<strong>Describer: </strong>The teacher hands each student two flat, thin wooden sticks.
</p>

<p>

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

<p>

<strong>Describer: </strong>The teacher holds two of the sticks to her mouth making the shape of a beak.
</p>

<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>

</li>

<li>

<p>

<strong>An alternative for time-based media for a training video</strong>

</p>

<p>A company purchases a Training video for use by its employees and puts it on the companies
<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>
</dd>
<dt>An alternative for time-based media for a training video</dt>
<dd>A company purchases a Training video for use by its employees and puts it on the companies
intranet. The video involves explaining use of a new technology and has a person talking
and showing things at the same time. Since there is no place to insert audio description
of the visual demonstrations during gaps in dialogue, the company provides an alternative
for time-based media that all employees, including those who cannot see the demonstrations,
can use to better understand what is being presented.
</p>

</li>

</ul>
can use to better understand what is being presented.</dd>
</dl>

</section>

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


<ol>
<ul>

<li>

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

</li>

</ol>
</ul>

</section>

Expand Down
29 changes: 8 additions & 21 deletions understanding/20/audio-description-prerecorded.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -76,19 +76,10 @@ <h2>Benefits of Audio Description (Prerecorded)</h2>
<section id="examples">
<h2>Examples of Audio Description (Prerecorded)</h2>


<ul>

<li>

<dl>
<dt>A movie with audio description</dt>
<dd>
<p>

<strong>A movie with audio description.</strong>

</p>

<p>

<strong>Describer: </strong>A title, "Teaching Evolution Case Studies. Bonnie Chen." A teacher shows photographs
of birds with long, thin beaks.
</p>
Expand All @@ -113,13 +104,9 @@ <h2>Examples of Audio Description (Prerecorded)</h2>
<strong>Describer: </strong>The teacher holds two of the sticks to her mouth making the shape of a beak.
</p>

<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>

</li>

</ul>
<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>
</dd>
</dl>

</section>

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


<ol>
<ul>

<li>

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

</li>

</ol>
</ul>

</section>

Expand Down
Loading

0 comments on commit 795a9bc

Please sign in to comment.