[wp-meta] [Making WordPress.org] #4519: Make the FAQ at plugin directory accessible

[Making WordPress.org]

#4519: Make the FAQ at plugin directory accessible
------------------------------+-------------------------
 Reporter:  Travel_girl       |      Owner:  (none)
     Type:  enhancement       |     Status:  new
 Priority:  normal            |  Milestone:
Component:  Plugin Directory  |   Keywords:  needs-patch
------------------------------+-------------------------
 Currently the FAQ-Section in the plugin  directory are not accessible for
 various reasons.

 Problems

 1. Questions don't have a semantic structure. They are just links at the
 moment
 2. with a click on the link, nothing happens for screen reader users
 3. aria-expandet is on the wrong element and don't announce anything to a
 screen reader user


 Suggested solutions:

 1. questions should be semantic headlines (H3 as FAQ is H2)
 2. those headlines should include a button-element to expand the section.
 Because it causes an action, it should be a Button, not a link
 3. this button should have an aria-expanded true/false, so it gets
 announced to an screen reader users


 Please also have a look on the buttons

 Further ressources about accessible accordions:

 https://www.w3.org/TR/wai-aria-practices-1.1/#accordion
 https://inclusive-components.design/collapsible-sections/

-- 
Ticket URL: <https://meta.trac.wordpress.org/ticket/4519>
Making WordPress.org <https://meta.trac.wordpress.org/>
Making WordPress.org