[wp-meta] [Making WordPress.org] #1486: wporg-p2 theme HTML headings hierarchy is not a11y-/web-standard

[Making WordPress.org]

#1486: wporg-p2 theme HTML headings hierarchy is not a11y-/web-standard
--------------------+-------------------------------------
Reporter:  hearvox  |      Owner:
    Type:  defect   |     Status:  new
Priority:  normal   |  Component:  make.wordpress.org / P2
Keywords:           |
--------------------+-------------------------------------
 The heading hierarchy used in the wporg-p2 theme at Make does not follow
 web-standards and so presents a11y problems. Many assistive technologies
 let users navigate a document by headings. The headings list is also how
 many users (and search engines) assess the content of document.

 My more immediate problem is I'd like to illustrate the A11y Handbook with
 screenshots of screen-reader displays, using the A11y Handbook as an
 example of how to do it right. However, I can't because the wporg-p2 theme
 does not currently do headings right.  (Aka, the A11y Handbook is not now
 in an accessible theme.)

 For instance, here's the A11y Handbook's "Get Involved" page:
 https://make.wordpress.org/accessibility/handbook/about/get-involved/

 Here's that page's headings (similar to how it looks in a screen-reader):
 .h1: WordPress.org
 ..h2: Make WordPress Accessible
 .h1: Menu
 ..h2: Chapters
 ..h2: Get Involved
 ......h6: Permalink
 ...h3: Topics
 ...h3: Who are we?
 ...h3: How do I get in touch?
 ...h3: Reply
 ......h6: Code is Poetry.

 The problems are: 1) The page title in not an `h1`. 2) The headings skip
 levels. 3) Many items aren't really section headings at all, but rather
 are `nav` or lists.

 A heading structure that semantically represents the page might be:
 .h1: Get Involved
 ..h2: Who are we?
 ..h2: How do I get in touch?
 ..h2: Reply

 I realize this suggested change would mean much pain, because of the
 needed theme changes. I'd be happy to help get those changes made, if Meta
 decides to pursue this.

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