Skip to content

Add accessibility section #327

Closed

Description

@LJWatson

In the WebApps charter it says:

Where there are implications for implementors, developers, or users, in the areas of accessibility, internationalization, privacy, and security, each specification must have a section that describes relevant benefits, limitations, and best practice solutions for that particular area.>

To this end each spec needs to have an accessibility section. For the avoidance of doubt in the reader, the section should be included even if it indicates there are no known accessibility considerations.

Relates to w3c/webappswg#15

Activity

  1. added this to the V3 milestone on Apr 9, 2020
  2. inexorabletash commented on Apr 9, 2020

    @inexorabletash
    Member

    It should also have an Internationalization section, to round out the horizontals.

    Are there any good templates to follow, or existing specs that speak to accessibility concerns well, especially for similar pure-API standards with no expected UI?

  3. added a commit that references this issue on Apr 9, 2020
    1ab41cf
  4. LJWatson commented on Apr 10, 2020

    @LJWatson
    Author

    We're blazing a bit of a trail on this. For an API like this where there is definitely no impact on the UI/accessibility, I'd suggest an "Accessibility" heading followed by a very short and simple section that says something like the following:

    This specification has no impact on the user interface and therefore there are no accessibility considerations for implementors, developers or users.>

  5. akuckartz commented on Apr 10, 2020

    @akuckartz

    For an API like this where there is definitely no impact on the UI/accessibility ...

    Are there any checklists regarding potential accessibility impacts of APIs?

  6. LJWatson commented on Apr 10, 2020

    @LJWatson
    Author

    There is the Framework for Accessible Specification of Technologies (FAST) with an associated FAST checklist.

    Worth noting that in 2016 the APA WG (that does horizontal review for accessibility) decided that this spec did not need accessibility review, presumably (if my memory serves) because it has no impact on the UI.

  7. inexorabletash commented on Apr 10, 2020

    @inexorabletash
    Member

    Awesome, thanks for the links. The checklist will provide a good format, even if mostly enumerating that this API does not have most of the relevant features.

    Note that user agents are likely to have some user interface elements associated with storage APIs even when the storage APIs do not define them - such as developer tools, or for end users to see which sites are storing data. I called that out in a draft PR.

  8. inexorabletash commented on Apr 10, 2020

    @inexorabletash
    Member

    Updated draft, direct link to the new accessibility section is https://pr-preview.s3.amazonaws.com/w3c/IndexedDB/pull/328.html#accessibility

  9. added a commit that references this issue on Apr 14, 2020
    40eb558
  10. added 3 commits that reference this issue on May 19, 2020
    a69534f
    f77d89c
    0048f99
  11. added
    a11y-trackerGroup bringing to attention of a11y, or tracked by the a11y Group but not needing response.
    on Jun 30, 2020
  12. inexorabletash commented on Jun 30, 2020

    @inexorabletash
    Member

    Anyone want to review the PR?

  13. pwnall commented on Jun 30, 2020

    @pwnall
  14. added a commit that references this issue on Jun 30, 2020
    59eeeb6
  15. LJWatson commented on Jun 30, 2020

    @LJWatson
    Author

    The accessibility section is terrific! Thanks @inexorabletash

  16. added a commit that references this issue on Feb 1, 2021
    7efa8d6
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Metadata

Metadata

Labels

a11y-trackerGroup bringing to attention of a11y, or tracked by the a11y Group but not needing response.has-pr

Type

No type

Projects

No projects

    Milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions