Text Appearance May 2025

guidelines/groups/text-and-wording/text-appearance.md

@@ -1,9 +1,37 @@
 ---
 children:
-  - maximum-text-contrast
-  - minimum-text-contrast
-  - text-size
-  - text-style
+  - readable-blocks-of-text
+  - readable-text-style
+  - adjustable-blocks-of-text
+  - adjustable-text-style
+  - content-and-functionality-not-lost-with-text-adjustment
+  - readable-blocks-of-text-supplemental
+  - readable-text-style-supplemental
 ---
 
 Users can read visually rendered text.
+
+:::decision-tree
+For each word of text:
+1. Is the text :term[purely decorative] or, is it not readable by anybody?
+   - Yes, Pass
+   - No, Continue
+2. Does the default/authored presentation meet minimum requirements?
+    1. Yes, the default/authored presentation meets <a href="#readable-blocks-of-text">Readable Blocks of Text (foundational)</a> and <a href="readable-text-style">Readable Text Style (foundational)</a>, Continue
+    2. No, Fail
+3. Can the text appearance be adjusted by the user?
+    1. Yes, text must be :term[user-manipulable text] and:
+        1. The :term[accessibility support set] meets:
+            1. <a href="#adjustable-blocks-of-text">Adjustable blocks of text</a>
+            2. <a href="#adjustable-text-style">Adjustable text style</a>
+        2. <a href="#content-and-functionality-not-lost-with-text-adjustment">Content and functional are not lost with text adjustment</a>
+        3. Pass
+    2. Yes, via produce-provided themes:
+        1. <a href="#adjustable-blocks-of-text">Adjustable blocks of text</a>
+        2. <a href="#adjustable-text-style">Adjustable text style</a>
+        3. <a href="#content-and-functionality-not-lost-with-text-adjustment">Content and functional are not lost with text adjustment</a>
+        4. Pass
+    3. No, and the product does not provide its own themes:
+        1. Fail.
+
+:::

guidelines/groups/text-and-wording/text-appearance/adjustable-blocks-of-text.md

@@ -0,0 +1,65 @@
+---
+needsAdditionalResearch: false
+status: developing
+---
+
+The presentation of :term[blocks of text] can be adjusted to meet the corresponding values for the content's language (or the most similar language of the ones listed).
+
+:::ednote
+Information could be lost if the user overrides the appearance. See [other structural guideline] about ensuring the structure conveys the meaning when possible.
+:::
+
+<table class="data">
+ <thead>
+   <tr>
+     <th>Characteristic</th>
+     <th>Arabic</th>
+     <th>Chinese</th>
+     <th>English</th>
+     <th>Hindi</th>
+     <th>Russian</th>
+   </tr>
+   </thead>
+   <tbody>
+     <tr>
+       <th>Inline margin</th>
+       <td></td>
+       <td></td>
+       <td></td>
+       <td></td>
+       <td></td>
+     </tr>
+    <tr>
+       <th>Block Margin</th>
+       <td></td>
+       <td></td>
+       <td></td>
+       <td></td>
+       <td></td>
+     </tr>  
+     <tr>
+       <th>Line length</th>
+       <td></td>
+       <td></td>
+       <td></td>
+       <td></td>
+       <td></td>
+     </tr>
+     <tr>
+       <th>Line height</th>
+       <td></td>
+       <td></td>
+       <td></td>
+       <td></td>
+       <td></td>
+     </tr>
+     <tr>
+       <th>Justification</th>
+       <td></td>
+       <td>Not applicable</td>
+       <td>Left aligned</td>
+       <td></td>
+       <td></td>
+     </tr>
+    </tbody>
+</table>

guidelines/groups/text-and-wording/text-appearance/adjustable-text-style.md

@@ -0,0 +1,100 @@
+---
+needsAdditionalResearch: false
+status: developing
+---
+
+The presentation of each of the following attributes can be adjusted to meet the corresponding values for the content’s language (or the most similar language of the ones listed).
+
+:::ednote
+Information could be lost if the user overrides the appearance. See [other structural guideline] about ensuring the structure conveys the meaning when possible.
+:::
+
+<table class="data">
+ <thead>
+   <tr>
+     <th>Characteristic</th>
+     <th>Arabic</th>
+     <th>Chinese</th>
+     <th>English</th>
+     <th>Hindi</th>
+     <th>Russian</th>
+   </tr>
+   </thead>
+   <tbody>
+     <tr>
+       <th>Underlining</th>
+       <td></td>
+       <td></td>
+       <td>
+        <ul>
+          <li>Disabled entirely</li>
+          <li>Enabled on links only</li>
+          <li>Enabled on links and author defined other text</li>
+        </ul>
+       </td>
+       <td></td>
+       <td></td>
+     </tr>
+    <tr>
+       <th>Italics</th>
+       <td></td>
+       <td></td>
+       <td>Disabled</td>
+       <td></td>
+       <td></td>
+     </tr>  
+     <tr>
+       <th>Bold</th>
+       <td></td>
+       <td></td>
+       <td>Disabled</td>
+       <td></td>
+       <td></td>
+     </tr>
+     <tr>
+       <th>Font face</th>
+       <td></td>
+       <td></td>
+       <td></td>
+       <td></td>
+       <td></td>
+     </tr>
+     <tr>
+       <th>Font width</th>
+       <td></td>
+       <td></td>
+       <td></td>
+       <td></td>
+       <td></td>
+     </tr>
+     <tr>
+       <th>Letter spacing</th>
+       <td></td>
+       <td></td>
+       <td></td>
+       <td></td>
+       <td></td>
+     </tr>
+     <tr>
+       <th>Capitalization</th>
+       <td></td>
+       <td></td>
+       <td>
+        <ul>
+          <li>Sentence case</li>
+          <li>Title case (headings, titles), sentence case for all other text</li>
+        </ul>
+       </td>
+       <td></td>
+       <td></td>
+     </tr>
+    <tr>
+       <th>Automatic hyphenation</th>
+       <td></td>
+       <td></td>
+       <td>Disabled</td>
+       <td></td>
+       <td></td>
+     </tr>
+    </tbody>
+</table>

guidelines/groups/text-and-wording/text-appearance/content-and-functionality-not-lost-with-text-adjustment.md

@@ -0,0 +1,6 @@
+---
+needsAdditionalResearch: false
+status: developing
+---
+
+When the content is adjusted according to [Adjustable blocks of text](#adjustable-blocks-of-text) and [Adjustable text style](#adjustable-text-style), content and functionality are not lost.

guidelines/groups/text-and-wording/text-appearance/readable-blocks-of-text-supplemental.md

@@ -0,0 +1,65 @@
+---
+needsAdditionalResearch: false
+status: developing
+---
+
+The default/authored presentation of :term[blocks of text] meets the corresponding values for the content’s language (or the most similar language of the ones listed).
+
+:::ednote
+[Readable blocks of text (foundational)](#readable-blocks-of-text) and [Readable text style (foundational)](#readable-text-style) are based on common usage, and their supplemental counterparts are based on readability research. We need more readability research in these languages.
+:::
+
+<table class="data">
+ <thead>
+   <tr>
+     <th>Characteristic</th>
+     <th>Arabic</th>
+     <th>Chinese</th>
+     <th>English</th>
+     <th>Hindi</th>
+     <th>Russian</th>
+   </tr>
+   </thead>
+   <tbody>
+     <tr>
+       <th>Inline margin</th>
+       <td></td>
+       <td></td>
+       <td></td>
+       <td></td>
+       <td></td>
+     </tr>
+    <tr>
+       <th>Block Margin</th>
+       <td></td>
+       <td></td>
+       <td></td>
+       <td></td>
+       <td></td>
+     </tr>  
+     <tr>
+       <th>Line length</th>
+       <td></td>
+       <td></td>
+       <td></td>
+       <td></td>
+       <td></td>
+     </tr>
+     <tr>
+       <th>Line height</th>
+       <td></td>
+       <td></td>
+       <td></td>
+       <td></td>
+       <td></td>
+     </tr>
+     <tr>
+       <th>Justification</th>
+       <td></td>
+       <td></td>
+       <td>Left aligned</td>
+       <td></td>
+       <td></td>
+     </tr>
+    </tbody>
+</table>

guidelines/groups/text-and-wording/text-appearance/readable-blocks-of-text.md

@@ -0,0 +1,65 @@
+---
+needsAdditionalResearch: false
+status: developing
+---
+
+The default/authored presentation of :term[blocks of text] meets the corresponding values for the content’s language (or the most similar language of the ones listed).
+
+:::ednote
+[Readable blocks of text (foundational)](#readable-blocks-of-text) and [Readable text style (foundational)](#readable-text-style) are based on common usage, and their supplemental counterparts are based on readability research. We need more readability research in these languages.
+:::
+
+<table class="data">
+ <thead>
+   <tr>
+     <th>Characteristic</th>
+     <th>Arabic</th>
+     <th>Chinese</th>
+     <th>English</th>
+     <th>Hindi</th>
+     <th>Russian</th>
+   </tr>
+   </thead>
+   <tbody>
+     <tr>
+       <th>Inline margin</th>
+       <td></td>
+       <td></td>
+       <td></td>
+       <td></td>
+       <td></td>
+     </tr>
+    <tr>
+       <th>Block Margin</th>
+       <td></td>
+       <td></td>
+       <td>≥0.5em around paragraphs</td>
+       <td></td>
+       <td></td>
+     </tr>  
+     <tr>
+       <th>Line length</th>
+       <td></td>
+       <td></td>
+       <td>30-100 characters</td>
+       <td></td>
+       <td></td>
+     </tr>
+     <tr>
+       <th>Line height</th>
+       <td></td>
+       <td></td>
+       <td>1.0 - paragraph separation height</td>
+       <td></td>
+       <td></td>
+     </tr>
+     <tr>
+       <th>Justification</th>
+       <td></td>
+       <td></td>
+       <td>Left aligned or Justified</td>
+       <td></td>
+       <td></td>
+     </tr>
+    </tbody>
+</table>