Home Page: Expand ARIA acronym, add APG acronym to h1, fix link label…

…s, fix mailing list link visibility (pull #2379) * Fix #2328: Change aria-label values to start with visible text of "Learn more" * Fix #2378: Revise wording of first paragraph to expand ARIA * Fix #2327: Move mailing list link outside paragraph so that it is not embedded in a block of text * Editorial change: Make path to examples more clear by changing first heading and paragraph under APG resources
w3c · Jun 22, 2022 · aac0931 · aac0931
1 parent 3ce9847
commit aac0931
Showing 1 changed file with 19 additions and 21 deletions.
diff --git a/index.html b/index.html
@@ -16,13 +16,11 @@
   </head>
   <body>
     <div id="top-card">
-      <h1>ARIA Authoring Practices Guide Home</h1>
+      <h1>ARIA Authoring Practices Guide (APG) Home</h1>
       <p>
-        Learn to use the accessibility semantics defined by ARIA 
-        to create accessible rich internet applications.
+        Learn to use the accessibility semantics defined by the Accessible Rich Internet Application (ARIA) specification to create accessible web experiences.
         This guide describes how to apply accessibility semantics to common design patterns and widgets.
-        It provides design patterns and functional examples
-        complemented by in-depth guidance for fundamental practices.
+        It provides design patterns and functional examples complemented by in-depth guidance for fundamental practices.
       </p>
       <a href="patterns/">View Patterns</a>
       <img
@@ -35,13 +33,12 @@ <h2>APG Resources</h2>
       <p>Building blocks that help you make the web accessible</p>
       <ul>
         <li>
-          <h3>Design Patterns and Widgets</h3>
+          <h3>Design Patterns and Examples</h3>
           <p>
-            Learn how to make common rich internet application patterns and
-            widgets accessible by applying WAI-ARIA roles, states and
-            properties, and implementing keyboard support.
+            Learn how to make accessible web components and widgets with ARIA roles, states and properties and by implementing keyboard support.
+            One or more ways of implementing each pattern is demonstrated with a functional example.
           </p>
-          <a href="patterns/" aria-label="View patterns">Learn More</a>
+          <a href="patterns/" aria-label="Learn more about APG patterns and examples">Learn More</a>
           <img alt="A menagerie of widgets." src="img/index-2.svg">
         </li>
         <li>
@@ -51,7 +48,7 @@ <h3>Use ARIA Landmarks</h3>
             to make it easy for assistive technology users to understand the
             meaning of the layout of a page.
           </p>
-          <a href="practices/landmark-regions/" aria-label="View landmarks guide">Learn More</a>
+          <a href="practices/landmark-regions/" aria-label="Learn more about ARIA landmarks">Learn More</a>
           <img
             alt="A document flies apart into chunks."
             src="img/index-3.svg"
@@ -65,7 +62,7 @@ <h3>Providing Accessible Names and Descriptions</h3>
             responsibilities authors have when developing accessible web
             experiences.
           </p>
-          <a href="practices/names-and-descriptions/" aria-label="View names and descriptions guide">Learn More</a>
+          <a href="practices/names-and-descriptions/" aria-label="Learn more about accessible names and descriptions">Learn More</a>
           <img
             alt="Indicators delve inside a document."
             src="img/index-4.svg"
@@ -77,7 +74,7 @@ <h3>And So Much More...</h3>
             Learn about other fundamental practices related to correctly using accessibility semantics,
             developing keyboard interfaces, and more.
           </p>
-          <a class="button-link" href="practices/" aria-label="View practices">Learn More</a>
+          <a class="button-link" href="practices/" aria-label="Learn more about APG practices">Learn More</a>
           <img
             alt="A box with an accessibility label is chock full of widgets and document bits."
             src="img/index-5.svg"
@@ -204,17 +201,18 @@ <h3>Contribute via GitHub</h3>
         <li>
           <h3>Mailing Lists</h3>
           <p>
-            The APG Task Force uses the public-aria-practices@w3.org mailing
-            list
-            <!-- prettier-ignore -->
-            <span>(<a
+            The APG Task Force uses the public aria-practices mailing list for email discussion. 
+            Meeting announcements, agendas, and links to minutes are sent to the mailing list.
+            While GitHub issues are the preferred place to discuss APG content, the mailing list is available to anyone who would prefer to communicate with the APG Task Force via email.
+          </p>
+          <p>
+            <a  
               rel="noopener noreferrer"
               target="_blank"
               href="https://lists.w3.org/Archives/Public/public-aria-practices/"
-              >view the mailing list archive</a>)</span>
-            for email discussion. 
-            Meeting announcements, agendas, and links to minutes are sent to the mailing list.
-            While GitHub issues are the preferred place to discuss APG content, the mailing list is available to anyone who would prefer to communicate with the APG Task Force via email.
+            >
+              View the aria-practices mailing list archive
+            </a>
           </p>
           <img
             alt="A notification bell icon appears over an email icon."