We're working on improving accessibility in our plugin. One of the rules for accessibility is apparently that you should have an h1 tag before any h2 or h3 tags etc. Normally that makes sense, except in the case of WordPress' admin help tabs, which are normally hidden, but appear ABOVE the rest of the page content. Does that mean we shouldn't put any header tags inside the wordpress help tabs? Eg see this screenshot where I have opened the help tab on an admin page (and have the tota11y plugin active showing the suggestions): https://drive.google.com/file/d/0B2KCao4zFjaxZTB6VEtORFhIMmc/view?usp=drivesdk

I would think having h tags in the help tab would help navigating the help tab right? Or should all the header tags used in the help tab be replaced with strong or span tags etc?

closed as primarily opinion-based by Howdy_McGee Sep 10 '16 at 22:10

Many good questions generate some degree of opinion based on expert experience, but answers to this question will tend to be almost entirely based on opinions, rather than facts, references, or specific expertise. If this question can be reworded to fit the rules in the help center, please edit the question.

  • 1
    Maybe I am totally wrong (and have to inform myself pretty fast, to correct my own assumptions/mistakes), but (not meant to be rude although it could sound like it) who checks that in the admin(the back-end)?...and what would be the negatives if ignoring those rules? For the front-end I know I follow those rules as far as possible (my lack of knowledge could still allow me to make even there mistakes of course) because Google 'looks over my shoulder' and will let me know how good I am with SEO. Did you try out and got negative results, or is it just an assumption? – Charles Jan 16 '16 at 0:17
  • @Charles ya it's probably most important on the frontend, but it's possible the site administrator is blind. So we'd want to make the admin accessible for them too, not just frontend users – thespacecamel May 2 '16 at 18:18

The WCAG Guidelines state (emphasis mine):

To facilitate navigation and understanding of overall document structure, authors should use headings that are properly nested (e.g., h1 followed by h2, h2 followed by h2 or h3, h3 followed by h3 or h4, etc.).

This implies that the reason they should be in the right order is so that people don't get confused by the structure. As you're in a pretty tricky situation here, my personal opinion is that they are more likely to be confused by a complete lack of headings than ones that are out of normal sequence so I'd say leave them in.

Not the answer you're looking for? Browse other questions tagged or ask your own question.