Editorial suggestions for consistent links to definitions and capitalization

guidelines/sc/20/audio-control.html

@@ -4,7 +4,7 @@ <h4>Audio Control</h4>
 
    <p class="conformance-level">A</p>
 
-   <p>If any audio on a Web page plays automatically for more than 3 seconds, either a <a>mechanism</a> is available to pause or stop the audio, or a mechanism is available to control audio
+   <p>If any audio on a Web page plays automatically for more than 3 seconds, either a <a>mechanism</a> is available to <a>pause</a> or stop the audio, or a mechanism is available to control audio
       volume independently from the overall system volume level.
    </p>
 
@@ -13,4 +13,4 @@ <h4>Audio Control</h4>
       to meet other success criteria) must meet this success criterion. See <a href="#cc5">Conformance Requirement 5: Non-Interference</a>.
    </p>
 
-</section>
+</section>

guidelines/sc/20/error-identification.html

@@ -5,7 +5,7 @@ <h4>Error Identification</h4>
    <p class="conformance-level">A</p>
 
    <p>If an <a>input error</a> is automatically detected, the item that is in error is identified and the error
-      is described to the user in text.
+     is described to the user in <a>text</a>.
    </p>
 
-</section>
+</section>

guidelines/sc/20/error-prevention-all.html

@@ -9,8 +9,8 @@ <h4>Error Prevention (All)</h4>
 
    <dl>
      <dt>Reversible</dt><dd>Submissions are reversible.</dd>
-     <dt>Checked</dt><dd>Data entered by the user is checked for input errors and the user is provided an opportunity to correct them.</dd>
-     <dt>Confirmed</dt><dd>A mechanism is available for reviewing, confirming, and correcting information before finalizing the submission.</dd>
+     <dt>Checked</dt><dd>Data entered by the user is checked for <a>input errors</a> and the user is provided an opportunity to correct them.</dd>
+     <dt>Confirmed</dt><dd>A <a>mechanism</a> is available for reviewing, confirming, and correcting information before finalizing the submission.</dd>
   </dl>
 
 </section>

guidelines/sc/20/error-prevention-legal-financial-data.html

@@ -10,8 +10,8 @@ <h4>Error Prevention (Legal, Financial, Data)</h4>
 
    <dl>
      <dt>Reversible</dt><dd>Submissions are reversible.</dd>
-     <dt>Checked</dt><dd>Data entered by the user is checked for input errors and the user is provided an opportunity to correct them.</dd>
-     <dt>Confirmed</dt><dd>A mechanism is available for reviewing, confirming, and correcting information before finalizing the submission.</dd>
+     <dt>Checked</dt><dd>Data entered by the user is checked for <a>input errors</a> and the user is provided an opportunity to correct them.</dd>
+     <dt>Confirmed</dt><dd>A <a>mechanism</a> is available for reviewing, confirming, and correcting information before finalizing the submission.</dd>
   </dl>
 
 </section>

guidelines/sc/20/focus-visible.html

@@ -4,8 +4,7 @@ <h4>Focus Visible</h4>
 
    <p class="conformance-level">AA</p>
 
-   <p>Any keyboard operable user interface has a mode of operation where the keyboard focus
-      indicator is visible.
+   <p>Any keyboard operable user interface has a mode of operation where the keyboard <a>focus indicator</a> is visible.
    </p>
 
-</section>
+</section>

guidelines/sc/20/language-of-parts.html

@@ -6,7 +6,7 @@ <h4>Language of Parts</h4>
 
    <p>The <a>human language</a> of each passage or phrase in the content can be <a>programmatically determined</a> except for proper names, technical terms, words of indeterminate language, and words
       or phrases that have become part of the vernacular of the immediately surrounding
-      text.
+     <a>text</a>.
    </p>
 
-</section>
+</section>

guidelines/sc/20/link-purpose-link-only.html

@@ -4,8 +4,8 @@ <h4>Link Purpose (Link Only)</h4>
 
    <p class="conformance-level">AAA</p>
 
-   <p>A <a>mechanism</a> is available to allow the purpose of each link to be identified from link text alone,
+  <p>A <a>mechanism</a> is available to allow the <a>purpose of each link</a> to be identified from link text alone,
       except where the purpose of the link would be <a>ambiguous to users in general</a>.
    </p>
 
-</section>
+</section>

guidelines/sc/20/name-role-value.html

@@ -5,12 +5,12 @@ <h4>Name, Role, Value</h4>
    <p class="conformance-level">A</p>
 
    <p>For all <a>user interface components</a> (including but not limited to: form elements, links and components generated by scripts),
-      the <a>name</a> and <a>role</a> can be <a>programmatically determined</a>; states, properties, and values that can be set by the user can be <a>programmatically set</a>; and notification of changes to these items is available to <a>user agents</a>, including <a>assistive technologies</a>.
+     the <a>name</a> and <a>role</a> can be <a>programmatically determined</a>; <a>states</a>, properties, and values that can be set by the user can be <a>programmatically set</a>; and notification of changes to these items is available to <a>user agents</a>, including <a>assistive technologies</a>.
    </p>
 
    <p class="note">This success criterion is primarily for Web authors who develop or script their own
       user interface components. For example, standard HTML controls already meet this success
       criterion when used according to specification.
    </p>
 
-</section>
+</section>

guidelines/sc/20/pause-stop-hide.html

@@ -15,7 +15,7 @@ <h4>Pause, Stop, Hide</h4>
 
          <p>For any moving, blinking or scrolling information that (1) starts automatically, (2)
             lasts more than five seconds, and (3) is presented in parallel with other content,
-            there is a mechanism for the user to <a>pause</a>, stop, or hide it unless the movement, blinking, or scrolling is part of an activity
+           there is a <a>mechanism</a> for the user to <a>pause</a>, stop, or hide it unless the movement, blinking, or scrolling is part of an activity
             where it is <a>essential</a>; and
          </p>
 
@@ -54,4 +54,4 @@ <h4>Pause, Stop, Hide</h4>
       progress could confuse users or cause them to think that content was frozen or broken.
    </p>
 
-</section>
+</section>

guidelines/sc/20/reading-level.html

@@ -4,8 +4,8 @@ <h4>Reading Level</h4>
 
    <p class="conformance-level">AAA</p>
 
-   <p>When text requires reading ability more advanced than the <a>lower secondary education level</a> after removal of proper names and titles, <a>supplemental content</a>, or a version that does not require reading ability more advanced than the lower
+  <p>When <a>text</a> requires reading ability more advanced than the <a>lower secondary education level</a> after removal of proper names and titles, <a>supplemental content</a>, or a version that does not require reading ability more advanced than the lower
       secondary education level, is available.
    </p>
 
-</section>
+</section>

guidelines/sc/20/timing-adjustable.html

@@ -41,7 +41,7 @@ <h4>Timing Adjustable</h4>
 
       <dd>
 
-         <p>The time limit is a required part of a real-time event (for example, an auction),
+        <p>The time limit is a required part of a <a>real-time event</a> (for example, an auction),
             and no alternative to the time limit is possible; or
          </p>
 
@@ -71,4 +71,4 @@ <h4>Timing Adjustable</h4>
       should be considered in conjunction with <a href="#on-focus">Success Criterion 3.2.1</a>, which puts limits on changes of content or context as a result of user action.
    </p>
 
-</section>
+</section>

guidelines/sc/20/visual-presentation.html

@@ -9,9 +9,9 @@ <h4>Visual Presentation</h4>
    <ul>
      <li>Foreground and background colors can be selected by the user.</li>   
      <li>Width is no more than 80 characters or glyphs (40 if CJK).</li>   
-     <li>Text is not justified (aligned to both the left and the right margins).</li>   
+     <li><a>Text</a> is not justified (aligned to both the left and the right margins).</li>   
      <li>Line spacing (leading) is at least space-and-a-half within paragraphs, and paragraph spacing is at least 1.5 times larger than the line spacing.</li>   
-     <li>Text can be resized without assistive technology up to 200 percent in a way that does not require the user to scroll horizontally to read a line of text <a>on a full-screen window</a>.</li>   
+     <li>Text can be resized without <a>assistive technology</a> up to 200 percent in a way that does not require the user to scroll horizontally to read a line of text <a>on a full-screen window</a>.</li>   
   </ul>
 
 </section>

guidelines/sc/21/content-on-hover-or-focus.html

@@ -19,7 +19,7 @@ <h4>Content on Hover or Focus</h4>
 
   </dl>
 
-    	<p>Exception: The visual presentation of the additional content is controlled by the user agent and is not modified by the author.</p>
+    	<p>Exception: The visual presentation of the additional content is controlled by the <a>user agent</a> and is not modified by the author.</p>
 
     	<p class="note">Examples of additional content controlled by the user agent include browser tooltips created through use of the HTML <a href="https://www.w3.org/TR/html/dom.html#the-title-attribute"><code>title</code> attribute</a>.</p>
      <p class="note">Custom tooltips, sub-menus, and other nonmodal popups that display on hover and focus are examples of additional content covered by this criterion.</p>

guidelines/sc/21/non-text-contrast.html

@@ -10,7 +10,7 @@ <h4>Non-text Contrast</h4>
 
       <dt>User Interface Components</dt>
 
-     <dd>Visual information required to identify <a>user interface components</a> and <a>states</a>, except for inactive components or where the appearance of the component is determined by the user agent and not modified by the author;</dd>
+     <dd>Visual information required to identify <a>user interface components</a> and <a>states</a>, except for inactive components or where the appearance of the component is determined by the <a>user agent</a> and not modified by the author;</dd>
 
       <dt>Graphical Objects</dt>
 

guidelines/sc/21/reflow.html

@@ -11,7 +11,7 @@ <h4>Reflow</h4>
    </ul>
    <p>Except for parts of the content which require two-dimensional layout for usage or meaning.</p>
 
-   <p class="note">320 CSS pixels is equivalent to a starting viewport width of 1280 CSS pixels wide at 400% zoom. For web content which is designed to scroll horizontally (e.g., with vertical text), 256 CSS pixels is equivalent to a starting viewport height of 1024 CSS pixels at 400% zoom.</p>
+  <p class="note">320 CSS pixels is equivalent to a starting <a>viewport</a> width of 1280 CSS pixels wide at 400% zoom. For web content which is designed to scroll horizontally (e.g., with vertical text), 256 CSS pixels is equivalent to a starting viewport height of 1024 CSS pixels at 400% zoom.</p>
 
    <p class="note">Examples of content which requires two-dimensional layout are images required for understanding (such as maps and diagrams), video, games, presentations, data tables (not individual cells), and interfaces where it is necessary to keep toolbars in view while manipulating content. It is acceptable to provide two-dimensional scrolling for such parts of the content.</p>
 

guidelines/sc/21/target-size-enhanced.html

@@ -9,11 +9,11 @@ <h4>Target Size (Enhanced)</h4>
 	<dt>Equivalent</dt> 
   <dd>The target is available through an equivalent link or control on the same page that is at least 44 by 44 CSS pixels;</dd>
 	<dt>Inline</dt> 
-  <dd>The target is in a sentence or block of text;</dd>
+  <dd>The target is in a sentence or <a>block of text</a>;</dd>
 	<dt>User Agent Control</dt> 
-  <dd>The size of the target is determined by the user agent and is not modified by the author;</dd>
+  <dd>The size of the target is determined by the <a>user agent</a> and is not modified by the author;</dd>
 	<dt>Essential</dt> 
-  <dd>A particular presentation of the target is <a>essential</a> to the information being conveyed.</dd>
+  <dd>A particular <a>presentation</a> of the target is <a>essential</a> to the information being conveyed.</dd>
 </dl>  
 
 </section>

guidelines/sc/21/text-spacing.html

@@ -13,6 +13,6 @@ <h4>Text Spacing</h4>
      <li>Word spacing to at least 0.16 times the font size.</li>
    </ul>
 
- <p>Exception: Human languages and scripts that do not make use of one or more of these text style properties in written text can conform using only the properties that exist for that combination of language and script.</p>
+   <p>Exception: <a>Human languages</a> and scripts that do not make use of one or more of these text style properties in written text can conform using only the properties that exist for that combination of language and script.</p>
 
 </section>

guidelines/sc/22/accessible-authentication-enhanced.html

@@ -5,12 +5,12 @@ <h4>Accessible Authentication (Enhanced)</h4>
     <p class="conformance-level">AAA</p>
 	<p class="change">New</p>
 
-    <p>A <a>cognitive function test</a> (such as remembering a password or solving a puzzle) is not required for any step in an authentication process unless that step provides at least one of the following:</p> 
+    <p>A <a>cognitive function test</a> (such as remembering a password or solving a puzzle) is not required for any step in an authentication <a>process</a> unless that step provides at least one of the following:</p> 
     <dl>
         <dt>Alternative</dt>
         <dd>Another authentication method that does not rely on a cognitive function test.</dd>
         <dt>Mechanism</dt>
-        <dd>A mechanism is available to assist the user in completing the cognitive function test.</dd>
+      <dd>A <a>mechanism</a> is available to assist the user in completing the cognitive function test.</dd>
     </dl>
 
  </section>

guidelines/sc/22/accessible-authentication.html

@@ -5,16 +5,16 @@ <h4>Accessible Authentication</h4>
     <p class="conformance-level">AA</p>
 	<p class="change">New</p>
 
-    <p>A <a>cognitive function test</a> (such as remembering a password or solving a puzzle) is not required for any step in an authentication process unless that step provides at least one of the following:</p> 
+    <p>A <a>cognitive function test</a> (such as remembering a password or solving a puzzle) is not required for any step in an authentication <a>process</a> unless that step provides at least one of the following:</p> 
     <dl>
         <dt>Alternative</dt>
         <dd>Another authentication method that does not rely on a cognitive function test.</dd>
         <dt>Mechanism</dt>
-        <dd>A mechanism is available to assist the user in completing the cognitive function test.</dd>
+      <dd>A <a>mechanism</a> is available to assist the user in completing the cognitive function test.</dd>
         <dt>Object Recognition</dt>
         <dd>The cognitive function test is to recognize objects.</dd>
         <dt>Personal Content</dt>
-        <dd>The cognitive function test is to identify non-text content the user provided to the website.</dd>
+      <dd>The cognitive function test is to identify <a>non-text content</a> the user provided to the Web site.</dd>
     </dl>
 
     <p class="note">"Object recognition" and "Personal content" may be represented by images, video, or audio.</p>

guidelines/sc/22/consistent-help.html

@@ -5,7 +5,7 @@ <h4>Consistent Help</h4>
     <p class="conformance-level">A</p>
 	<p class="change">New</p>
 
-    <p>If a <a>web page</a> contains any of the following help mechanisms, and those mechanisms are repeated on multiple web pages within a <a>set of web pages</a>, they occur in the same order relative to other page content, unless a change is initiated by the user:</p>
+  <p>If a <a>Web page</a> contains any of the following help <a>mechanisms</a>, and those mechanisms are repeated on multiple Web pages within a <a>set of Web pages</a>, they occur in the same order relative to other page content, unless a change is initiated by the user:</p>
 
     <ul>
         <li>Human contact details;</li>

guidelines/sc/22/dragging-movements.html

@@ -5,7 +5,7 @@ <h4>Dragging Movements</h4>
     <p class="conformance-level">AA</p>
 	<p class="change">New</p>
 
-    <p>All functionality that uses a <a>dragging movement</a> for operation can be achieved by a <a>single pointer</a> without dragging, unless dragging is <a>essential</a> or the functionality is determined by the user agent and not modified by the author.</p>
+  <p>All <a>functionality</a> that uses a <a>dragging movement</a> for operation can be achieved by a <a>single pointer</a> without dragging, unless dragging is <a>essential</a> or the functionality is determined by the <a>user agent</a> and not modified by the author.</p>
     <p class="note">This requirement applies to web content that interprets pointer actions (i.e. this does not apply to actions that are required to operate the user agent or assistive technology).</p>
 
  </section>

guidelines/sc/22/focus-appearance.html

@@ -11,7 +11,7 @@ <h4>Focus Appearance</h4>
 
             <ul>
                 <li><a>encloses</a> the <a>user interface component</a>  or sub-component that is focused, and</li>
-                <li>has a contrast ratio of at least 3:1 between the same pixels in the focused and unfocused states, and</li>
+              <li>has a <a>contrast ratio</a> of at least 3:1 between the same pixels in the focused and unfocused <a>states</a>, and</li>
                 <li>has a contrast ratio of at least 3:1 against adjacent non-focus-indicator colors.</li>
             </ul>
         </li>
@@ -26,7 +26,7 @@ <h4>Focus Appearance</h4>
 
     <p>Exceptions:</p>
     <ul>
-        <li>The focus indicator is determined by the user agent and cannot be adjusted by the author, or</li>
+      <li>The focus indicator is determined by the <a>user agent</a> and cannot be adjusted by the author, or</li>
         <li>The focus indicator and the indicator's background color are not modified by the author.</li>
     </ul>
 

guidelines/sc/22/target-size-minimum.html

@@ -10,8 +10,8 @@ <h4>Target Size (Minimum)</h4>
         <li><strong>Spacing:</strong> The target does not overlap any other target and has a <a>target offset</a> of at least 24 CSS pixels to every adjacent target;</li>
         <li><strong>Equivalent:</strong> The function can be achieved through a different control on the same page that meets this criterion.</li>
         <li><strong>Inline:</strong> The target is in a sentence, or is in a bulleted or numbered list, or its size is otherwise constrained by the line-height of non-target text;</li>
-        <li><strong>User agent control:</strong> The size of the target is determined by the user agent and is not modified by the author;</li>
-        <li><strong>Essential:</strong> A particular presentation of the target is <a>essential</a> or is legally required for the information being conveyed;</li>
+        <li><strong>User agent control:</strong> The size of the target is determined by the <a>user agent</a> and is not modified by the author;</li>
+      <li><strong>Essential:</strong> A particular <a>presentation</a> of the target is <a>essential</a> or is legally required for the information being conveyed;</li>
     </ul>
     <p class="note">Targets that allow for values to be selected spatially based on position within the target are considered one target for the purpose of the success criterion. Examples include sliders with granular values, color pickers displaying a gradient of colors, or editable areas where you position the cursor.</p>
     <p class="note">For inline targets the line-height should be interpreted as perpendicular to the flow of text. For example, in a language displayed top to bottom, the line-height would be horizontal.</p>

guidelines/terms/20/assistive-technology.html

@@ -29,7 +29,7 @@
 
    <aside class="example"><p>Assistive technologies that are important in the context of this document include
       the following:
-   </p></aside>
+   </p>
 
    <ul>
 
@@ -58,6 +58,6 @@
          to simulate mouse pointing and button activations.
       </li>
 
-   </ul>
+   </ul></aside>
 
 </dd>

guidelines/terms/20/blocks-of-text.html

@@ -1,6 +1,6 @@
-<dt><dfn>blocks of text</dfn></dt>
+<dt><dfn data-lt="block of text">blocks of text</dfn></dt>
 <dd>
 
-   <p>more than one sentence of text</p>
+  <p>more than one sentence of <a>text</a></p>
 
-</dd>
+</dd>

guidelines/terms/20/image-of-text.html

@@ -1,11 +1,11 @@
 <dt><dfn data-lt="images of text">image of text</dfn></dt>
 <dd>
 
-   <p>text that has been rendered in a non-text form (e.g., an image) in order to achieve
+  <p><a>text</a> that has been rendered in a non-text form (e.g., an image) in order to achieve
       a particular visual effect
    </p>
 
-   <p class="note">This does not include <a>text</a> that is part of a picture that contains significant other visual content.
+   <p class="note">This does not include text that is part of a picture that contains significant other visual content.
    </p>
 
    <aside class="example"><p>A person's name on a nametag in a photograph.</p></aside>