W3C home > Mailing lists > Public > public-cognitive-a11y-tf@w3.org > March 2019

RE: WAI landing page for CogA

From: Shawn Henry <shawn@w3.org>
Date: Fri, 8 Mar 2019 14:52:26 -0600
To: "James A." <A.James@soton.ac.uk>
Cc: public-cognitive-a11y-tf <public-cognitive-a11y-tf@w3.org>
Message-ID: <20d8491a-58aa-c302-afef-e9cf2124e9d0@w3.org>
Hi Abi,

Thanks much for the input at <https://lists.w3.org/Archives/Public/public-cognitive-a11y-tf/2019Mar/0036.html>. I agree that sentence is not totally smooth.

<start message>
I am struggling with the sentence " They are under these and other guidelines:" in the section on Cognitive Accessibility in W3C standards. It does not seem a clear way to say this. My suggestion would be to add "such as" to the previous sentence so that it read:
For example, Web Content Accessibility Guidelines (WCAG) includes requirements (called “success criteria”) that improve cognitive accessibility such as:
</end message>


The issue is that the sentence talks about requirements/success criteria, yet the list is of guidelines (not success criteria). Also, some on the TF call wanted to avoid "For example" and "such as" in the same sentence -- which I agree with.

A couple of options:
1. For example, Web Content Accessibility Guidelines (WCAG) includes requirements that improve cognitive accessibility. The requirements (called “success criteria”) are in guidelines such as:
2. For example, Web Content Accessibility Guidelines (WCAG) includes requirements that improve cognitive accessibility. The requirements (called “success criteria”) are in these and other guidelines:

I do think #1 is more straightforward. However, it seem to me a bit wimpy. We really want this section to be strong. For that reason, I'm thinking #2 -- or something more like it -- might be better. Thoughts?

Thanks,
~Shawn
<http://www.w3.org/People/Shawn/>
Received on Friday, 8 March 2019 20:52:35 UTC

This archive was generated by hypermail 2.4.0 : Thursday, 24 March 2022 20:24:02 UTC