Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Home Page: Expand ARIA acronym, add APG acronym to h1, fix link labels, fix mailing list link visibility #2379

Merged
merged 5 commits into from
Jun 22, 2022
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
40 changes: 19 additions & 21 deletions index.html
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand All @@ -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>
Expand All @@ -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"
Expand All @@ -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"
Expand All @@ -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"
Expand Down Expand Up @@ -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."
Expand Down