diff --git a/ARIA/apg/about/about.md b/ARIA/apg/about/about.md index 669a2bce0..922059fae 100644 --- a/ARIA/apg/about/about.md +++ b/ARIA/apg/about/about.md @@ -67,6 +67,13 @@ lang: en ARIA Basics.

+
  • +

    Contributing to the APG

    +

    + The APG Task Force relies on broad community representation and participation to continuously improve the usefulness and quality of the APG. + Learn how you can contribute and help promote development of accessible experiences. +

    +
  • Acknowledgements

    diff --git a/ARIA/apg/about/contributing/contributing.md b/ARIA/apg/about/contributing/contributing.md new file mode 100644 index 000000000..274226480 --- /dev/null +++ b/ARIA/apg/about/contributing/contributing.md @@ -0,0 +1,176 @@ +--- +# This file was generated by scripts/pre-build/library/formatForJekyll.js +title: "Contributing to the APG" +ref: /ARIA/apg/about/contributing/ + +github: + repository: w3c/aria-practices + branch: main + path: content/about/contributing/contributing.html +feedbackmail: public-aria-practices@w3.org +permalink: /ARIA/apg/about/contributing/ + +sidebar: true + + + +# Context here: https://github.com/w3c/wai-aria-practices/issues/31 +type_of_guidance: APG + +lang: en +--- + + +Contributing to the APG + + + + + + + + + + + + + + +

    + +
    + + +
    +

    Introduction

    +

    + Continuous improvement to the utility and quality of the ARIA Authoring Practices Guide (APG) depends on broad community input and participation. + Anyone may contribute feedback, suggestions, or code via the channels described below. + However, if you would like to contribute regularly, please consider + joining the Authoring Practices Task Force. + As a task force participant, you and your organization have greater influence over APG development, and are listed as contributors where appropriate. +

    +
    + +
    +

    Providing feedback

    +

    + The APG provides two public feedback channels -- GitHub and email. + Links to both are provided at the bottom of every page in the APG. +

    +

    + GitHub issues are the best way to ask a question, make a suggestion, or report a problem. + Before creating a new issue, it is helpful if you first review existing issues to determine whether there is an issue addressing the same concern. + If so, please comment on that issue rather than raising another. + If the concern you would like addressed is related to an example implementation of an APG pattern, at the bottom of the page, next to the revision date, there is a link named "Related Issues". + That link opens a GitHub project containing all issues associated with the relevant pattern and its examples. +

    +

    + View and create APG issues on GitHub. +

    +

    + The task force also uses the aria-practices public 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 by + sending email to the ARIA Authoring Practices public mailing list. +

    +

    + View the aria-practices mailing list archive. +

    +
    + +
    +

    Making improvements to documentation or code

    +

    + If you would like to help improve the APG with enhancements or fixes to documentation or code, please adhere to the following procedure. +

    +
      +
    1. Get your development environment ready: + +
    2. +
    3. Comment in an existing issue or raise a new issue, expressing your willingness to help and briefly summarizing the nature of your proposed resolution.
    4. +
    5. An editor will confirm there are no conflicting plans and, if needed, provide guidance.
    6. +
    7. Do some fabulous work and submit a pull request.
    8. +
    9. Watch your GitHub notifications and respond to feedback during the pull request review process.
    10. +
    +

    + If you run into any difficulties, please feel free to ask questions either via a GitHub issue or by + sending email to the ARIA Authoring Practices public mailing list. +

    +
    + +
    +

    Joining The Authoring Practices Task Force

    +

    + The APG is developed by the + ARIA Authoring Practices Task Force, + which is a sub-group of the + ARIA Working Group. + The task force meets weekly to coordinate work on development of the APG. + Task force participants are expected to regularly attend meetings and to actively contribute. + Examples of contributions include: +

    +
      +
    • Testing the functionality and accessibility of example implementations of the APG patterns
    • +
    • Fixing bugs and implementing enhancements in example implementations of the APG patterns
    • +
    • Helping write responses to community feedback
    • +
    • Reviewing and editing documentation
    • +
    • Designing or engineering pattern implementation examples
    • +
    • Creating and editing patterns and practices for ARIA usage
    • +
    +

    + To participate in the Authoring Practices Task Force, you first need to + become a participant in the ARIA Working Group. + If you are already a participant in the ARIA Working Group, contact + Daniel Montalvo + and request membership in the Authoring Practices Task Force. +

    +
    + +
    +

    Helping provide assistive technology support data

    +

    + The assistive technology support tables included on APG example pages, e.g., + Assistive Technology Support for Radio Group Example Using aria-activedescendant, + are provided by the + ARIA and Assistive Technologies (ARIA-AT) Community Group. + The ARIA-AT community group aims to ensure APG patterns have consistent and interoperable accessibility support. + If you would like to contribute to this aspect of the APG, you can learn more about the ARIA-AT project and how to contribute at + ARIA and Assistive Technologies Home. +

    +
    + +
    + +
    + diff --git a/_external/aria-practices b/_external/aria-practices index 2b619c14b..7fb7c8e28 160000 --- a/_external/aria-practices +++ b/_external/aria-practices @@ -1 +1 @@ -Subproject commit 2b619c14b45ef0a566e91219bb3eef195b62b776 +Subproject commit 7fb7c8e28b55a2804bda682c36945a1154d1096a