overlayfactsheet icon indicating copy to clipboard operation
overlayfactsheet copied to clipboard

Published 20 hours ago • verified publisher icon karlgroves

Content structure suggestion

Open stringyland opened this issue 4 years ago • 2 comments

At the moment the page is a wall of text, which is good because it covers a lot of detail that we need to capture. But it's not as SEO-friendly as it could be.

My suggestion is to break up the sections a bit more and use more conversational phrases for headings. Because doing audits has trained me to think in terms of headings, I've put my idea as a heading structure below.

This would be a big change to the current page so I won't make a pull request until I've had some feedback on it.

  • H1 - Overlay Fact Sheet
    • H2 - What's an accessibility overlay?
    • H2 - Strengths and weakness of overlays. (This section could be a nice side-by-side bullet point list, followed by a sentence about how if you want to know more about the potential benefits you should check with the overlay vendors, but we'll be focusing on the weaknesses.)
      • H3 - Overlays will not make you WCAG compliant
      • H3 - Overlays create more access problems than they solve (could include In Their Own Words here, or give it it's own visually-distinct highlighted section).
      • H3 - Overlays invade privacy
      • H3 - Overlays cannot fix content that isn't in HTML, CSS or JavaScript
      • H3 - Overlays create performance problems
    • H2 - What do we recommend instead of overlays? (Could have some subsections here depending on how much content we have. See karlgroves/overlayfactsheet#36 )
    • H2 - Conclusion
    • H2 - Statement from Sponsors and Signatories to this Fact Sheet
      • H3 - Signed by
    • H2 - Additional reading

stringyland avatar Mar 13 '21 08:03 stringyland

Potential Strengths of Overlays list:

  • Most accessibility overlays are easy to install
  • People without disabilities will feel good about doing business with an organisation which cares about people with disabilities
  • May be useful to people who have newly acquired disabilities and are not yet aware of the assistive technology that is available to them

This is sort of "damn them with faint praise", and the second one throws a fair amount of shade. I don't want to be sarcastic but I think it's important to our credibility to mention that there are some limited advantages. Hopefully they will be outweighed by other considerations.

stringyland avatar Mar 13 '21 08:03 stringyland

@stringyland I apologize for letting this rot, but can you issues a PR with the changes you propose?

karlgroves avatar May 04 '21 16:05 karlgroves