search

w3c / wai-website

This repository hosts the WAI Website.
https://www.w3.org/WAI/
Other
46 stars 153 forks source link

[ED-MED ] Tools and Technique pages could use more introductory text #537

Open MicheleAWilliams-A11y opened 8 months ago

MicheleAWilliams-A11y commented 8 months ago

Wanted to give the feedback that overall I'm not sure a layperson would be able to follow the "Tools and Techniques" subpages as they are. For now it feels like the audience would be something like accessibility trainers who want to ensure they don't forget something in their examples. If this is okay, then you can disregard.

To expound, the "Interaction/Navigation" page most closely met my page expectations more than the other subpages. This is because it described the content and situations in the Introduction rather than going straight into the paragraphs of "people use X or Y" and high-level examples of how tech design and code can help. The bulleted lists and way of saying who this helps in the Interaction/Navigation page make that content more inviting, relatable, and memorable. If there's opportunity to replicate this page's Introduction section for the other pages, I think that would boost the readability and usefulness tremendously.

JayneSchurick commented 8 months ago

I'm not sure I'm following your issue. What is the "interaction" page? I'd like to see the page you think is a good example. Thanks.

MicheleAWilliams-A11y commented 8 months ago

This is regarding the pages from our last survey:

The "Introduction" section of the Interaction page has more explanatory text that speaks to the overall theme first then lists scenarios.

The other subpages of Tools and Techniques start by saying "Some people [use/need]..." which doesn't give the same 'warm-up' to the topic.

Other pages:

Hope that helps!

JayneSchurick commented 8 months ago

tools-techniques-navigation