Skip to content

Commit

Permalink
deploy: 409e3c0
Browse files Browse the repository at this point in the history
  • Loading branch information
@rachaelbradley
rachaelbradley committed Nov 26, 2024
1 parent 5500c7d commit e23d259
Show file tree
Hide file tree
Showing 18 changed files with 216 additions and 257 deletions.
5 changes: 3 additions & 2 deletions guidelines/index.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -352,13 +352,14 @@ <h4>Clear meaning</h4>
<summary>Which foundational provision applies?</summary>
<p>For each item of ambiguous text, such as <a>non-literal text</a>, abbreviations and acronyms, <a>ambiguous numbers</a>, or text missing letters or diacritics:</p>
<ol>
<li>Is the ambiguous text presented in a way that is available to <a>user agents</a>, including assistive technology?
<li>Is the text presented in a way that is available to <a>user agents</a>, including assistive technology (AT)?
<ul>
<li>Yes, view meets <a href="#detectable-text">Text is programmatically determinable</a>, continue. </li>
<li>No, continue to step 3. </li>
</ul>
</li>
<li>Does the accessibility support set meet <a href="#unambiguous-text">Explain ambiguous text or provide an unambiguous alternative</a>?

<li>Does the <a>accessibility support set</a> meet <a href="unambiguous-text">Explain ambiguous text or provide an unambiguous alternative</a>?
<ul>
<li>Yes, pass. Stop. </li>
<li>No, continue. </li>
Expand Down
36 changes: 26 additions & 10 deletions how-to/clear-meaning/index.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -70,6 +70,14 @@ <h2>Goal</h2>
<li>Use clear, unambiguous language, or</li>
<li>Explain the implied meaning of ambiguous language.</li>
</ul>
<p>This guideline covers four types of ambiguous text content:</p>
<ul>
<li><strong>non-literal text</strong>, such as idioms, metaphors, similes, and sarcasm,</li>
<li><strong>abbreviations or acronyms</strong> that are not defined on first use,</li>
<li><strong>ambiguous numbers</strong>, such as date formatting that can have different meanings in different cultures, and</li>
<li><strong>text that leaves out letters or diacritics</strong> needed to read the words phonetically, such as in Arabic and Hebrew.</li>
</ul>
<p>For each instance of ambiguous text content, the goal is to ensure clarity and provide necessary context.</p>
<p>Making ambiguous content (including non-literal or figurative language) easier to understand helps people with cognitive disabilities as well as neurodivergent people, such as those who are autistic and may be so focused on the literal meaning that they may not notice the implied meaning.</p>
<p>Explaining or avoiding ambiguous language can also help:</p>
<ul>
Expand All @@ -85,21 +93,21 @@ <h3>Guideline</h3>
<h3>Foundational Requirements</h3>
<p>For each item of ambiguous text, such as non-literal text, abbreviations and acronyms, ambiguous numbers, or text missing letters or diacritics:</p>
<ol>
<li>Is the non-literal text presented in a way that is available to user agents, including assistive technology (AT)?
<li>Is the ambiguous text presented in a way that is available to user agents, including assistive technology (AT)?
<ol>
<li>Yes, view meets <em>Text is programmatically determinable</em>, continue.</li>
<li>No, continue to step 3.</li>
</ol>
</li>
<li>Does the <em>accessibility support set</em> meet <em>Explain ambiguous text or provide an unambiguous alternative</em>?
<li>Does the <em>accessibility support set</em> meet <a href="methods/explain-ambiguous-text/">Explain ambiguous text or provide an unambiguous alternative</a>?
<ol>
<li>Yes, pass.</li>
<li>Yes, pass. Stop.</li>
<li>No, continue.</li>
</ol>
</li>
<li>Does the publisher sufficiently explain the non-literal text or provide a literal alternative?
<li>Does the author meet <a href="methods/explain-ambiguous-text/">Explain ambiguous text or provide an unambiguous alternative</a>?
<ol>
<li>Yes, view meets <em>Explain non-literal text or provide a literal alternative</em>, pass.</li>
<li>Yes, pass. Stop.</li>
<li>No, fail.</li>
</ol>
</li>
Expand All @@ -109,7 +117,7 @@ <h4>Exceptions</h4>
<li>If the purpose is to showcase works of art or fiction, such as a poetry journal or fictional stories, this guideline does not apply; however, if the purpose is to educate students about pieces of art, then this guideline applies.</li>
</ul>
</div>
<h3>Supplimental Requirements</h3>
<h3>Supplemental Requirements</h3>
<p class="ednote">None defined at this time.</p>
<h3>Assertions</h3>
<p class="ednote">There will probably be a generic assertion based on style guides that applies to this guideline.</p>
Expand All @@ -121,13 +129,17 @@ <h2>What to do</h2>
<li>Hint at a meaning that is not directly stated, or</li>
<li>Can have more than one meaning, such as working on a literal and figurative level at the same time. Example in English: “The chef cuts corners when slicing the fish.” Non-literal: The chef is preparing the fish in an easy or cheap way. Literal: The chef is cutting the fish into shapes that don’t have sharp corners.</li>
</ul>
<p>When checking for non-literal text, also consider how sentences are combined together, such as if a word in one sentence is critical to accurately understanding the meaning of a later sentence.</p>
<p>If the text has implied meaning, explain it or provide a literal alternative using one of the techniques in the <a href=".methods/">Methods</a> section.</p>
<p>When checking for ambiguous text, also consider how sentences are combined together, such as if a word in one sentence is critical to accurately understanding the meaning of a later sentence.</p>
<p>If the text has implied meaning, explain it or provide an unambiguous alternative using one of the techniques in the <a href=".methods/">Methods</a> section.</p>
</div>
<h2>Definitions</h2>
<ul>
<li><strong>Abbreviation</strong>: TBD (a shortened form of a word or a phrase).</li>
<li><strong>Acronym</strong>: TBD (a type of abbreviation formed from the initial letters of other words, often pronounced as a word).</li>
<li><strong>Ambiguous number</strong>: TBD (such as when date formatting can have different meanings in different cultures).</li>
<li><strong>Ambiguously pronounced text</strong>: TBD (including words that leave out letters or diacritics needed to read the words phonetically, such as in Arabic and Hebrew.)</li>
<li><strong>Back translation</strong> is a two-step process of translating text into another language and then back to its original language. Also called reverse translation, this process can help identify phrases that may lose their intended meaning when translated.</li>
<li><strong>Content publisher</strong> The creative individual or organization responsible for curating, producing, and distributing various forms of content to engage and inform audiences. Includes tools used by the publisher such as HTML and JSON and content management systems like Wix and WordPress.</li>
<li><strong>Diacritic</strong>: TBD, (a sign, such as an accent or other type of glyph, when added above or below a letter indicates a difference in pronunciation from the same letter when unmarked or marked differently) such as in Arabic and Hebrew.</li>
<li><strong>Emoji character</strong> An emoji character is a small digital image with Unicode for its literal meaning, such as 🌴(“Palm tree”). But emojis often have implied meaning that users may need help understanding. Common examples of emojis used in non-literal ways:
<ul>
<li>💯(“Hundred points”) can be used in various ways, such as to indicate a perfect score or complete agreement.</li>
Expand All @@ -140,8 +152,12 @@ <h2>Definitions</h2>
<li>Examples: Allusions, hyperbole, idioms, irony, jokes, litotes, metaphors, metonymies, onomatopoeias, oxymorons, personification, puns, sarcasm, and similes. More detailed examples are available in the <a href=".methods/">Methods</a> section.</li>
</ul>
</li>
<li><strong>Publisher</strong> The individual or organization responsible for curating, producing, and distributing various forms of content to engage and inform audiences. Includes tools used by the publisher such as HTML and JSON and content management systems like Wix and WordPress.</li>
<li><strong>User agent</strong> W3C defines user agent as any software that retrieves, renders, and facilitates end-user interaction with Web content, or whose user interface is implemented using Web technologies.
Examples: Web browsers, media players, operating system shells, plug-ins, consumer electronics with Web-widgets, and stand-alone applications or embedded applications that help in retrieving, rendering, and interacting with Web content.</li>
<ul>
<li>Examples: Web browsers, media players, operating system shells, plug-ins, consumer electronics with Web-widgets, and stand-alone applications or embedded applications that help in retrieving, rendering, and interacting with Web content.</li>
</ul>
</li>
</ul>

</main>
Expand Down
24 changes: 13 additions & 11 deletions how-to/clear-meaning/methods/explain-ambiguous-text/index.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -66,28 +66,30 @@
</div>
<main id="main" tabindex="-1">
<h1>Explain ambiguous text or provide an unambiguous alternative</h1>
<p>@@@</p>
<p></p>
<dl class="method-card">
<div>
<dt>Level: Foundational</dt>
<dd>@@@</dd>
<dt>Level:</dt>
<dd>Foundational</dd>
</div>
</dl>
<p>Determine if the text has:</p>
<ul>
<li>non-literal text,</li>
<li>abbreviations and acronyms,</li>
<li>ambiguous numbers, or</li>
<li>text missing letters or diacritics</li>
<li>Non-literal text, such as idioms, metaphors, similes, and sarcasm.</li>
<li>Abbreviations or acronyms that are not explained on first use.</li>
<li>Ambiguous numbers such as date formatting that can have different meanings in different cultures.</li>
<li>Text that leaves out letters or diacritics needed to read the words phonetically, such as in Arabic or Hebrew.</li>
</ul>
<p>If the text is ambiguous, explain it or provide an alternative using one of the techniques in the techniques section.</p>
<h2>Techniques</h2>
<ul>
<li><strong>Author technique (General):</strong> Spell out the meaning in brackens after the first use.</li>
<li><strong>Author technique (General):</strong> Linking to a glossary.</li>
<li><strong>Author technique (HTML):</strong> Include text that explains the meaning using an abbriviation.</li>
<li><strong>Author technique (General)</strong>: Explain the meaning in brackets after the first use.</li>
<li><strong>Author technique (General)</strong>: Explain the meaning in a consecutive block of text.</li>
<li><strong>Author technique (General)</strong>: Include a link to a glossary, pop-up, or tooltip.</li>
<li><strong>Author technique (General)</strong>: Use translation tools to help identify ambiguous text during back translation.</li>
<li><strong>Author technique (HTML)</strong>: Include text that explains the meaning using an abbreviation <code>&lt;abbr&gt;</code> element.</li>
</ul>

<p class="ednote">This guideline will include definitions and examples in English of common types of non-literal text. This guideline will also link to examples of non-literal text in a wide variety of languages, including Arabic, Chinese (Mandarin), Hindi, Japanese, and Russian.</p>
</main>
</div>
<footer class="site-footer grid-4q" aria-label="Site">
Expand Down
4 changes: 2 additions & 2 deletions how-to/clear-meaning/methods/index.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -71,7 +71,7 @@ <h2>Foundational Requirements</h2>
<li><a href="explain-ambiguous-text">Explain ambiguous text or provide an unambiguous alternative</a></li>
</ul>
</div>
<h2>Supplimental</h2>
<h2>Supplemental</h2>
<div class="nested">
<ul>
<li>None available</li>
Expand All @@ -80,7 +80,7 @@ <h2>Supplimental</h2>
<h2>Methods</h2><div class="card">
<h3>Explain ambiguous text or provide an unambiguous alternative</h3>
<div class="flex">
<p>@@@</p>
<p></p>
<p><a href="/wcag3/how-to/clear-meaning/methods/explain-ambiguous-text" class="card-button">See More</a></p>
</div>
</div>
Expand Down
6 changes: 3 additions & 3 deletions how-to/focus-appearance/activities/test/index.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -62,10 +62,10 @@ <h3>Custom focus indicator</h3>
</div>
</div>
<div class="card">
<h3>Using the default focus indicator</h3>
<h3>r</h3>
<div class="flex">
<p>The platform's default indicator is used.</p>
<p><a href="/wcag3/how-to/focus-appearance/methods/default-focus-indicator/test/" class="card-button">See More</a></p>
<p>Focusable item uses the user agent default indicator.</p>
<p><a href="/wcag3/how-to/focus-appearance/methods/User-agent default indicator/test/" class="card-button">See More</a></p>
</div>
</div>
<div class="card">
Expand Down
8 changes: 4 additions & 4 deletions how-to/focus-appearance/index.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -79,24 +79,24 @@ <h3>Foundational Requirements</h3>
<p>For each focusable item:</p>
<ol>
<li>
<p>Is the user-agent default focus indicator used? (Prerequisite)</p>
<p>Is the user-agent default focus indicator used?</p>
<ol>
<li>Yes, the <a href="methods/default-focus-indicator">user-agent default indicator</a> is used AND the <em>accessibility support set</em> meets <a href="methods/custom-focus-indicator">Custom focus indicators</a>. Stop.</li>
<li>No, continue.</li>
</ol>
</li>
<li>
<p>Is the focus indicator defined by the author? (Baseline)</p>
<p>Is the focus indicator defined by the author?</p>
<ol>
<li>Yes, indicator must meet <a href="methods/custom-focus-indicator">Custom focus indicators</a>. Stop.</li>
<li>No, fail.</li>
</ol>
</li>
</ol>
</div>
<h3>Supplimental Requirements</h3>
<h3>Supplemental Requirements</h3>
<ul>
<li><a href="methods/supplimentary-indicators">Supplimentary indicators</a>.</li>
<li><a href="methods/supplementary-indicators">Supplementary indicators</a>.</li>
</ul>
<h3>Assertions</h3>
<ul>
Expand Down
6 changes: 3 additions & 3 deletions how-to/focus-appearance/methods/custom-focus-indicator/index.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -294,10 +294,10 @@ <h3>Custom focus indicator</h3>
</div>
</div>
<div class="card">
<h3>Using the default focus indicator</h3>
<h3>r</h3>
<div class="flex">
<p>The platform's default indicator is used.</p>
<p><a href="/wcag3/how-to/focus-appearance/methods/default-focus-indicator" class="card-button">See More</a></p>
<p>Focusable item uses the user agent default indicator.</p>
<p><a href="/wcag3/how-to/focus-appearance/methods/User-agent default indicator" class="card-button">See More</a></p>
</div>
</div>
<div class="card">
Expand Down
6 changes: 3 additions & 3 deletions how-to/focus-appearance/methods/default-focus-indicator/index.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
<html lang="en">
<head>
<meta charset="utf-8">
<title>WCAG 3.0 Using the default focus indicator Method - Introduction</title>
<title>WCAG 3.0 r Method - Introduction</title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<link rel="stylesheet" href="https://w3.org/WAI/assets/css/style.css">
<link rel="stylesheet" href="/wcag3/how-to/assets/main.css">
Expand Down Expand Up @@ -69,8 +69,8 @@
</nav>
</div>
<main id="main" tabindex="-1">
<h1>Using the default focus indicator</h1>
<p>The platform's default indicator is used.</p>
<h1>r</h1>
<p>Focusable item uses the user agent default indicator.</p>
<dl class="method-card">
<div>
<dt>Level:</dt>
Expand Down
12 changes: 7 additions & 5 deletions how-to/focus-appearance/methods/index.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -78,10 +78,12 @@ <h2>Foundational Requirements</h2>
<li><a href="other-indicators/">Other indicators</a></li>
</ul>
</div>
<h2>Supplimental</h2>
<h2>Supplemental Requirements</h2>
<div class="nested">
<ul>
<li><a href="methods/supplimentary-indicators">Supplimentary indicators</a></li>
<li><a href="methods/supplementary-indicators">Supplementary indicators</a></li>
</ul>
</div>
<h2>Methods</h2><div class="card">
<h3>Custom focus indicator</h3>
<div class="flex">
Expand All @@ -90,10 +92,10 @@ <h3>Custom focus indicator</h3>
</div>
</div>
<div class="card">
<h3>Using the default focus indicator</h3>
<h3>r</h3>
<div class="flex">
<p>The platform's default indicator is used.</p>
<p><a href="/wcag3/how-to/focus-appearance/methods/default-focus-indicator" class="card-button">See More</a></p>
<p>Focusable item uses the user agent default indicator.</p>
<p><a href="/wcag3/how-to/focus-appearance/methods/User-agent default indicator" class="card-button">See More</a></p>
</div>
</div>
<div class="card">
Expand Down
28 changes: 13 additions & 15 deletions how-to/text-alternatives/index.html → how-to/image-alternatives/index.html
View file
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@
<html lang="en">
<head>
<meta charset="utf-8">
<title>WCAG 3.0 Text Alternatives Outcome - </title>
<title>WCAG 3.0 Outcome - </title>
<meta name="viewport" content="width=device-width, initial-scale=1">
<link rel="stylesheet" href="https://w3.org/WAI/assets/css/style.css">
<link rel="stylesheet" href="/wcag3/how-to/assets/main.css">
Expand Down Expand Up @@ -48,7 +48,7 @@
<nav class="default-grid breadcrumb" aria-label="Breadcrumb" lang="en">
<ul>
<li><a href="/wcag3/how-to/">All WCAG 3 Outcomes</a></li>
<li><a href="/wcag3/how-to/text-alternatives/" aria-current="page">Text Alternatives</a></li>
<li><a href="/wcag3/how-to/image-alternatives/" aria-current="page">Image Alternatives</a></li>
</ul>
</nav>

Expand All @@ -57,49 +57,47 @@
<nav class="sn-contents" aria-label="Secondary">
<ul class="sidenav--list">
<li>
<a aria-current="page" href="/wcag3/how-to/text-alternatives/">Text Alternatives</a></li><li>
<a href="/wcag3/how-to/text-alternatives/methods/">Methods</a></li>
</ul>
<a href="/wcag3/how-to/"></a></li></ul>
</nav>
</div>
<main id="main" tabindex="-1">
<h1>Text Alternatives</h1>
<h1></h1>
<h2>Goal</h2>
<p>A user is provided an understandable description of the information or functionality contained within an image.
If there is no information conveyed by the image, the user's assistive technology should be able to ignore the image.</p>
<h2>Normative text</h2>
<div class="normative">
<h3>Guideline</h3>
<p>Users have equivalent text alternatives for all images.</p>
<p></p>
<div class="nested">
<h3>Foundational Requirements</h3>
<ol>
<li>
<p>Would removing the image impact how people understand the page? (Prerequisite)</p>
<p>Would removing the image impact how people understand the page?</p>
<ol>
<li>No, <a href="methods/decorative-images">decorative images are programmatically hidden</a>. Stop.</li>
<li>No, <a href="methods/decorative-images">decorative image is programmatically hidden</a>. Stop.</li>
<li>Yes, continue.</li>
</ol>
</li>
<li>
<p>Is the image presented in a way that is available to user agents and assistive technology? (Prerequisite)</p>
<p>Is the image presented in a way that is available to user agents and assistive technology?</p>
<ol>
<li>Yes, image must meet <em>Image is programmatically determinable</em> AND the <em>accessibility support set</em> incorporates <a href="methods/equivalent-alternative-text">Equivalent text alternatives are available for images that convey content</a>. Stop.</li>
<li>Yes, image must meet <em>Image is programmatically determinable</em> AND the <em>accessibility support set</em> incorporates <a href="methods/equivalent-alternative-text">Equivalent text alternative is available for image that conveys content</a>. Stop.</li>
<li>No, continue.</li>
</ol>
</li>
<li>
<p>Is an equivalent text alternative available for the image? (Baseline)</p>
<p>Is an equivalent text alternative available for the image?</p>
<ol>
<li>Yes, image must meet <a href="methods/equivalent-alternative-text">Equivalent text alternatives are available for images that convey content</a>. Stop.</li>
<li>Yes, image must meet <a href="methods/equivalent-alternative-text">Equivalent text alternative is available for image that conves content</a>. Stop.</li>
<li>No, fail.</li>
</ol>
</li>
</ol>
</div>
<h3>Supplimental Requirements</h3>
<h3>Supplemental Requirements</h3>
<ul>
<li><a href="methods/role-of-images">The role and importance of images are programmatically indicated</a> (Supporting requirement).</li>
<li><a href="methods/role-of-images">The role and importance of the image is programmatically indicated</a> (Supporting requirement).</li>
<li><a href="methods/type-of-image">The type of image (photo, icon, etc.) is indicated</a> (Supporting requirement).</li>
<li><a href="methods/editable-alt-text">Auto generated text descriptions are editable by content creator</a> (Supporting requirement).</li>
</ul>
Expand Down
Loading

0 comments on commit e23d259

Please sign in to comment.