From e23d2594fa220cd4802ce0df75d00fd31a59348b Mon Sep 17 00:00:00 2001 From: rachaelbradley Date: Tue, 26 Nov 2024 14:27:43 +0000 Subject: [PATCH] deploy: 409e3c031cc28e282536f4dd78b84adc6592e51b --- guidelines/index.html | 5 +- how-to/clear-meaning/index.html | 36 ++-- .../methods/explain-ambiguous-text/index.html | 24 +-- how-to/clear-meaning/methods/index.html | 4 +- .../activities/test/index.html | 6 +- how-to/focus-appearance/index.html | 8 +- .../methods/custom-focus-indicator/index.html | 6 +- .../default-focus-indicator/index.html | 6 +- how-to/focus-appearance/methods/index.html | 12 +- .../index.html | 28 ++- .../methods/complex-images/index.html | 10 +- .../methods/control-images/index.html | 10 +- .../methods/decorative-images/index.html | 10 +- .../equivalent-alternative-text/index.html | 10 +- how-to/image-alternatives/methods/index.html | 116 ++++++++++++ .../methods/multiple-images/index.html | 10 +- how-to/index.html | 6 +- how-to/text-alternatives/methods/index.html | 166 ------------------ 18 files changed, 216 insertions(+), 257 deletions(-) rename how-to/{text-alternatives => image-alternatives}/index.html (95%) rename how-to/{text-alternatives => image-alternatives}/methods/complex-images/index.html (97%) rename how-to/{text-alternatives => image-alternatives}/methods/control-images/index.html (97%) rename how-to/{text-alternatives => image-alternatives}/methods/decorative-images/index.html (97%) rename how-to/{text-alternatives => image-alternatives}/methods/equivalent-alternative-text/index.html (97%) create mode 100644 how-to/image-alternatives/methods/index.html rename how-to/{text-alternatives => image-alternatives}/methods/multiple-images/index.html (97%) delete mode 100644 how-to/text-alternatives/methods/index.html diff --git a/guidelines/index.html b/guidelines/index.html index b4889f0..d849882 100644 --- a/guidelines/index.html +++ b/guidelines/index.html @@ -352,13 +352,14 @@

Clear meaning

Which foundational provision applies?

For each item of ambiguous text, such as non-literal text, abbreviations and acronyms, ambiguous numbers, or text missing letters or diacritics:

    -
  1. Is the ambiguous text presented in a way that is available to user agents, including assistive technology? +
  2. Is the text presented in a way that is available to user agents, including assistive technology (AT)?
    3. -
  3. Does the accessibility support set meet Explain ambiguous text or provide an unambiguous alternative? + +
  4. Does the accessibility support set meet Explain ambiguous text or provide an unambiguous alternative?
    • Yes, pass. Stop.
    • No, continue.
      • diff --git a/how-to/clear-meaning/index.html b/how-to/clear-meaning/index.html index ce3cc3a..d1ba075 100644 --- a/how-to/clear-meaning/index.html +++ b/how-to/clear-meaning/index.html @@ -70,6 +70,14 @@

      Goal

    • Use clear, unambiguous language, or
    • Explain the implied meaning of ambiguous language.
    +

    This guideline covers four types of ambiguous text content:

    +
      +
    • non-literal text, such as idioms, metaphors, similes, and sarcasm,
      • +
    • abbreviations or acronyms that are not defined on first use,
      • +
    • ambiguous numbers, such as date formatting that can have different meanings in different cultures, and
      • +
    • text that leaves out letters or diacritics needed to read the words phonetically, such as in Arabic and Hebrew.
      • +
    +

    For each instance of ambiguous text content, the goal is to ensure clarity and provide necessary context.

    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.

    Explaining or avoiding ambiguous language can also help:

      @@ -85,21 +93,21 @@

      Guideline

      Foundational Requirements

      For each item of ambiguous text, such as non-literal text, abbreviations and acronyms, ambiguous numbers, or text missing letters or diacritics:

        -
      1. Is the non-literal text presented in a way that is available to user agents, including assistive technology (AT)? +
      2. Is the ambiguous text presented in a way that is available to user agents, including assistive technology (AT)?
        1. Yes, view meets Text is programmatically determinable, continue.
        2. No, continue to step 3.
        3. -
      3. Does the accessibility support set meet Explain ambiguous text or provide an unambiguous alternative? +
      4. Does the accessibility support set meet Explain ambiguous text or provide an unambiguous alternative?
          -
        1. Yes, pass.
          2. +
        2. Yes, pass. Stop.
        3. No, continue.
        5. -
      5. Does the publisher sufficiently explain the non-literal text or provide a literal alternative? +
      6. Does the author meet Explain ambiguous text or provide an unambiguous alternative?
          -
        1. Yes, view meets Explain non-literal text or provide a literal alternative, pass.
          2. +
        2. Yes, pass. Stop.
        3. No, fail.
        7. @@ -109,7 +117,7 @@

        Exceptions

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

    Supplimental Requirements

    +

    Supplemental Requirements

    None defined at this time.

    Assertions

    There will probably be a generic assertion based on style guides that applies to this guideline.

    @@ -121,13 +129,17 @@

    What to do

  5. Hint at a meaning that is not directly stated, or
  6. 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.
    7. -

    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.

    -

    If the text has implied meaning, explain it or provide a literal alternative using one of the techniques in the Methods section.

    +

    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.

    +

    If the text has implied meaning, explain it or provide an unambiguous alternative using one of the techniques in the Methods section.

    Definitions

    diff --git a/how-to/clear-meaning/methods/explain-ambiguous-text/index.html b/how-to/clear-meaning/methods/explain-ambiguous-text/index.html index 45376f0..5c5b13d 100644 --- a/how-to/clear-meaning/methods/explain-ambiguous-text/index.html +++ b/how-to/clear-meaning/methods/explain-ambiguous-text/index.html @@ -66,28 +66,30 @@

    Explain ambiguous text or provide an unambiguous alternative

    -

    @@@

    +

    -
    Level: Foundational
    -
    @@@
    +
    Level:
    +
    Foundational

    Determine if the text has:

      -
    • non-literal text,
      • -
    • abbreviations and acronyms,
      • -
    • ambiguous numbers, or
      • -
    • text missing letters or diacritics
      • +
    • Non-literal text, such as idioms, metaphors, similes, and sarcasm.
      • +
    • Abbreviations or acronyms that are not explained on first use.
      • +
    • Ambiguous numbers such as date formatting that can have different meanings in different cultures.
      • +
    • Text that leaves out letters or diacritics needed to read the words phonetically, such as in Arabic or Hebrew.

    If the text is ambiguous, explain it or provide an alternative using one of the techniques in the techniques section.

    Techniques

      -
    • Author technique (General): Spell out the meaning in brackens after the first use.
      • -
    • Author technique (General): Linking to a glossary.
      • -
    • Author technique (HTML): Include text that explains the meaning using an abbriviation.
      • +
    • Author technique (General): Explain the meaning in brackets after the first use.
      • +
    • Author technique (General): Explain the meaning in a consecutive block of text.
      • +
    • Author technique (General): Include a link to a glossary, pop-up, or tooltip.
      • +
    • Author technique (General): Use translation tools to help identify ambiguous text during back translation.
      • +
    • Author technique (HTML): Include text that explains the meaning using an abbreviation <abbr> element.
    - +

    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.