WebAIM - Web Accessibility In Mind

E-mail List Archives

resources on writing accessible user guides


From: Scott Brackett
Date: Apr 16, 2021 12:27PM

Hi all,
I'm looking for additional resources/guidelines about writing better user
guides for websites/web applications, specifically:

- Best practices for navigation description: instead of "click to the
left of X..." I would tend towards using "select X under the Y heading."
What are some other options?
- Should we stop using sight-based idioms like "look" and "see"? Are
those to be avoided in favor of "...find the X link after the Y heading" or
"if you are searching for X, select the Y link under the Z heading...."
Or is that over-thinking it?
- What are recommendations on what interaction descriptor to use instead
of "click?" Are "select" or "choose" good options? Any others?

I really appreciate any help you can provide.
Scott B.