Link to Success Criteria in submit a tool form and in tool list itself

[iadawn]

When adding a tool the Accessibility features section includes a reference to the ATAG success criteria, for example 'See also: A. 1.1'.

This should link to the ATAG Success Criteria.

[hidde]

Agreed. Adding this to my to do list… 

[shawna-slh]

For now I added to the listing page:

The Details section under the Tools listing has information on how the tool meets the web standard: Authoring Tool Accessibility Guidelines (ATAG). For a brief summary of ATAG, see ATAG at a Glance.

And in the submission form:

The 'See also's below refer to the section of ATAG.

[csarven]

+1. Came here to create this issue. I've found the reference to criteria useful to look it up but a link would be handy.

Unless the following approach was ruled out early in the form design, I'd like to suggest considering to reuse guideline text in the form, e.g.:

A.1.1. (For the authoring tool user interface) Ensure that web-based functionality is accessible

• Yes
• No
• Partially
• Not applicable
• Not sure

Perhaps also taking changes of context into account somewhere "(opens in new tab/window)" after the guideline text so that the user doesn't loose the (filled out) form at some point. Alternatively, the guideline text can be used as the content of the summary element in details, and the opened content showing more information.

[shawna-slh]

Thanks much for the input, @csarven !

... a link would be handy

+1 (we just haven't gotten to adding that yet, given other priorities)

I'd like to suggest considering to reuse guideline text in the form

As I recall, the form creator thought paraphrase would be easier to understand.

+1 to revisiting that. Perhaps we provide both?

... after the guideline text so that the user doesn't loose the (filled out) form at some point. Alternatively, the guideline text can be used as the content of the summary element in details, and the opened content showing more information.

Noting here for when we come back to this issue: in the report tools, we have both: "Show full description [+]" and links to Understanding in new window.

---

Having said all that, I will note that we have limited resources for this project, and others have had higher priority. We will address the most important issues, and not sure if/when we will get to non-essential enhancements.

[shawna-slh]

Related issue is that we are getting feedback about confusion over the wording in the list page as well. The paraphrasing make it unclear how it relates to ATAG. So for the list page, we should also consider:

• add link to ATAG SC [fairly easy]
• provide a way to see both the paraphrase and the actual SC text [more time to figure out UI and program it]
• other ways to meet the needs of users who are familiar with ATAG and users who are not