Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Content structure suggestion #111

Open
stringyland opened this issue Mar 13, 2021 · 2 comments
Open

Content structure suggestion #111

stringyland opened this issue Mar 13, 2021 · 2 comments

Comments

@stringyland
Copy link
Collaborator

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 Add a section: Alternatives to overlays? #36 )
    • H2 - Conclusion
    • H2 - Statement from Sponsors and Signatories to this Fact Sheet
      • H3 - Signed by
    • H2 - Additional reading
@stringyland
Copy link
Collaborator Author

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.

@karlgroves
Copy link
Owner

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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

2 participants