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

Edits to draft contributing page by Jon Gunderson #2774

Merged
merged 6 commits into from
Sep 20, 2023
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
49 changes: 41 additions & 8 deletions content/about/contributing/contributing.html
Original file line number Diff line number Diff line change
Expand Up @@ -21,20 +21,53 @@ <h1>Contributing to the APG</h1>
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 contribute and help promote development of accessible experiences.
</p>
<section id="get_involved">
<h2>Get Involved</h2>
<h3>Join the Task Force</h3>
<section id="working_groups">
<h2>Join a Working Group</h2>

<h3>ARIA Authoring Practices Group 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.
The <a target="_blank" href="https://www.w3.org/WAI/ARIA/task-forces/practices/">ARIA Authoring Practices Task Force</a> is a sub-group of the <a target="_blank" href="https://www.w3.org/WAI/ARIA/">ARIA Working Group</a>. The group meets weekly to coordinate the development activities of the practices. Members are expected to regularly attend meetings and to actively contribute to the development of the practices. Examples of member contributions include:
</p>
<a 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>
<h3>Contribute via GitHub</h3>
<ul>
<li>Testing examples for WCAG compliance</li>
<li>Reviewing and editing example documentation</li>
<li>Creating code and test cases for examples</li>
<li>Creating and editing patterns of ARIA usage</li>
<li>Reviewing issues and responding to commenters</li>
</ul>

<p>NOTE: Participation in the task force is limited to members of the W3C and invited experts.</p>

<h3>ARIA and Assistive Technologies Community Group</h3>
<p>
The <a target="_blank" href="https://www.w3.org/community/aria-at/">ARIA and Assistive Technologies Community Group</a> is testing the implementation of assistive technology support for ARIA. The community group also works with AT vendors to improve the consistency of how ARIA information is conveyed to users. Results of implementation testing are integrated into the associated examples in the ARIA Authoring Practices. The group meets weekly to coordinate the development of tests and testing with assistive technologies. Members are expected to regularly attend meetings and to actively contribute to the assistive technology testing. Examples of member participation include:
</p>
<ul>
<li>Running test cases on specific screen readers and web browser</li>
<li>Providing feedback on test case development</li>
</ul>

<p>NOTE: Participation in the community group is open to anyone, assistive technology users are encouraged to participate.</p>
</section>

<section id="other_ways">
<h2>Other Ways to Contribute</h2>

<h3>Raise a Github Issue</h3>
<p>
The APG Task Force uses GitHub issues to manage the activities of the working group. Creating an issue is the best way to ask a question or report problems with an example or other information in the ARIA Authoring Practices. Before creating a new issue, please review the current list of issues to see if your question has been asked or your problem reported. If an issue already exists feel free to add your own comments to the issue. New issues are reviewed in the weekly APG meetings.
</p>
<p>
<a target="_blank" href="https://github.com/w3c/aria-practices/issues">View and create APG issues on GitHub.</a>
</p>

<h3>Contribute Code 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 target="_blank" href="https://github.com/w3c/aria-practices">View ReadMe in the GitHub repository</a>

<h3>Mailing Lists</h3>
<p>
The APG Task Force uses the public aria-practices mailing list for email discussion.
Expand All @@ -49,4 +82,4 @@ <h3>Mailing Lists</h3>
</main>
</body>

</html>
</html>