w3c · daniel-montalvo · Sep 4, 2024 · Dec 19, 2024 · Jan 5, 2025
diff --git a/ARIA/apg/apg-home.md b/ARIA/apg/apg-home.md
diff --git a/_external/aria-practices b/_external/aria-practices
diff --git a/_external/data b/_external/data
diff --git a/content-assets/wai-aria-practices/apg-home.html.sistemcat b/content-assets/wai-aria-practices/apg-home.html.sistemcat
@@ -0,0 +1,102 @@
+<!DOCTYPE html>
+<html lang="en">
+  <head>
+    <!-- This file will be consumed and transformed into its final state by the wai-aria-practices repo. -->
+    <meta charset="UTF-8">
+    <meta http-equiv="X-UA-Compatible" content="IE=edge">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>ARIA Authoring Practices Guide</title>
+    <style>
+      img {
+        display: block;
+        max-width: 300px;
+      }
+    </style>
+
+    <script data-skipto="colorTheme:aria; displayOption:popup; containerElement:div" src="shared/js/skipto.js"></script>
+
+  </head>
+  <body>
+    <div id="top-card">
+      <h1>ARIA Authoring Practices Guide (APG) Home</h1>
+      <p>
+        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.
+      </p>
+      <a href="patterns/patterns.html">View Patterns</a>
+      <img alt="A laptop screen fills with an accessibility icon and emits a checkmark." src="images/index-1.svg">
+    </div>
+    <div id="resources">
+      <h2>APG Resources</h2>
+      <p>Building blocks that help you make the web accessible</p>
+      <ul>
+        <li>
+          <h3>Design Patterns and Examples</h3>
+          <p>
+            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/patterns.html" aria-label="Learn more about APG patterns and examples">Learn More</a>
+          <img alt="A menagerie of widgets." src="images/index-2.svg">
+        </li>
+        <li>
+          <h3>Use ARIA Landmarks</h3>
+          <p>Learn how to use HTML sectioning elements and ARIA landmark roles to make it easy for assistive technology users to understand the meaning of the layout of a page.</p>
+          <a href="practices/landmark-regions/landmark-regions-practice.html" aria-label="Learn more about ARIA landmarks">Learn More</a>
+          <img alt="A document flies apart into chunks." src="images/index-3.svg">
+        </li>
+        <li>
+          <h3>Providing Accessible Names and Descriptions</h3>
+          <p>Providing elements with accessible names and, where appropriate, accessible descriptions is one of the most important responsibilities authors have when developing accessible web experiences.</p>
+          <a href="practices/names-and-descriptions/names-and-descriptions-practice.html" aria-label="Learn more about accessible names and descriptions">Learn More</a>
+          <img alt="Indicators delve inside a document." src="images/index-4.svg">
+        </li>
+        <li>
+          <h3>And So Much More...</h3>
+          <p>Learn about other fundamental practices related to correctly using accessibility semantics, developing keyboard interfaces, and more.</p>
+          <a class="button-link" href="practices/practices.html" 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="images/index-5.svg">
+        </li>
+      </ul>
+    </div>
+
+    <div id="collaboration">
+      <h2 class="collaboration-h2">Get Involved</h2>
+      <p class="collaboration-p">
+        The APG Task Force relies on broad community representation and participation to continuously improve the usefulness and quality of the APG.
+        There are a variety of ways you can get involved and help promote development of accessible experiences.
+      </p>
+      <ul>
+        <li>
+          <h3>Join the Task Force</h3>
+          <p>
+            To join the APG Task Force, individuals need to first join the W3C ARIA Working Group.
+            Participants are expected to actively contribute to the work of the task force.
+          </p>
+          <a rel="noopener noreferrer" target="_blank" href="https://www.w3.org/WAI/ARIA/task-forces/practices/">Learn more about the work of the task force and how to join</a>
+          <img alt="An icon showing three nodes connecting." src="images/index-6.svg">
+        </li>
+        <li>
+          <h3>Contribute via GitHub</h3>
+          <p>
+            Many valuable contributions are made by people who find or raise issues of interest in our GitHub repository and then submit proposed changes via a GitHub pull request.
+            If you choose this path, please start by studying our guidelines for contributing to the repository and maintaining code quality.
+          </p>
+          <a rel="noopener noreferrer" target="_blank" href="https://github.com/w3c/aria-practices">View ReadMe in the GitHub repository</a>
+          <img alt="An icon showing two human shapes carrying a burden." src="images/index-7.svg">
+        </li>
+        <li>
+          <h3>Mailing Lists</h3>
+          <p>
+            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 aria-practices mailing list archive</a></p>
+          <img alt="A notification bell icon appears over an email icon." src="images/index-8.svg">
+        </li>
+      </ul>
+    </div>
+  </body>
+</html>
+0 −0		content/apg-home.html.sistemcat
+1 −0		cspell.json
+2,936 −2,758		package-lock.json
+16 −16		package.json
+12 −5		test/tests/combobox_grid-combo.js
+4 −0		test/tests/disclosure_navigation_hybrid.js
+7 −2		test/tests/toolbar_toolbar.js
+8 −0		test/util/isMacOS.js
+45 −0		test/util/translatePlatformKeys.js
+4 −0		navigation.yml
+21 −7		translations.yml
+1 −0		video-metadata.yml
+148 −0		wai-videos/video-introduction/video-introduction.tr.vtt