Re: final review for content usable 1.0

Hello, I'm adding a few more corrections in pull requests. Meanwhile, here
are a couple more overall comments that stand out for us to potentially
address in the future:

User Story: Adapt is not the only place where both "easy to understand
language" (without hyphens) and "easy-to-understand language" (with
hyphens) are used. These two ways of writing this appear to be used
interchangeably throughout the document. Is this intentional?

Design Guide is not the only section where both terms, "cognitive and
learning disabilities" and "cognitive and learning impairments" are used.
These two terms appear to be used interchangeably throughout the document.
Is this intentional?

I've seen this comment before in a thread, but wanted to note that it stood
out in the document: list item punctuation is inconsistent throughout. In
some places, each list item ends with a period even if it is not a complete
sentence. Some areas end each item with a common, until the second to last
one which ends with "and". Other places have no punctuation even if each
list item contains a full or nearly full sentence.

Under 4.4.1.2 What To Do:
There is a recommendation to "look at the 1500 most common words," but this
feels unhelpful without a link or resource included (I found this, but it
is English-specific: https://www.englishspeak.com/en/english-words)

I'm more than happy to do the work of finding and correcting these items in
the code, but would need to know from the group if (1) these are
intentional, and (2) which style we would like to use.

Thank you,

Rain

On Mon, Mar 8, 2021 at 5:43 PM Rain Michaels <rainb@google.com> wrote:

> I am so impressed with all of the work that has been done.
>
> In the spirit of editing:
>
> I've created several pull requests on the consistency_checks branch with
> minor corrections that seemed obvious and objective.
>
> I'm not done going through, but wanted to make sure to send what I have as
> soon as possible. I'll try to get through the rest of the document tomorrow.
>
> Here are a couple of comments for items that are more subjective:
>
> *3.1.2 User Story: Clear Operation*
>
> As an individual with dyslexia, the opening paragraph confused me: *"As a
> user with a memory impairment, a learning disability, or a communication
> disability who uses symbols, or executive function impairment, I find it
> hard to learn new interface design patterns. I need to know which controls
> are available and how to use them so that the site is usable for me."*
>
> I was able to follow the first three user examples, but the forth one ("or
> executive function impairment") felt like it was tacked on and didn't fit
> into the list. I spent more time than I should have re-thinking the
> sentence.
>
> Suggestions to fix:
>
> Suggestion 1:  put them in a list
>
> *As a user with*
>
>    - *a memory impairment*
>    - *a learning disability*
>    - *a communication disability who uses symbols*
>    - *an executive function impairment*
>
> Suggestion 2: tweak the "or" and "a" usage in the sentence
>
> *As a user with a memory impairment, a learning disability, a
> communication disability who uses symbols, or an executive function
> impairment,...*
>
> *3.8.1 User Story: Adapt*
>
> I noticed that sometimes the document uses "easy to understand" as three
> separate words, and sometimes we use "easy-to-understand" with hyphens.
>
> Is there a reason for the two styles?
>
> The third bullet in this section uses both:
>
> *"I need content delivered in an easy to understand language or an
> easy-to-understand mode (like short, understandable, video clips)."*
>
> *4. Design Guide*
>
> In the intro paragraph, I noticed that we used the word "cognitive and
> learning impairments" instead of "cognitive and learning disabilities,"
> which is different from the language elsewhere. Not sure if there is a
> specific reason for this, but it stands out.
>
>
> On Thu, Mar 4, 2021 at 8:19 AM Lisa Seeman <lisa1seeman@gmail.com> wrote:
>
>> Hi Folks
>>
>> We (editors) are doing the final changes from the issues to content
>> useable 1.0. However, it will still need to be reviewed, as sometimes when
>> you fix one thing you brake another (and we have a dyslexic editor...).
>>
>> We will hopefully get any changes done over the weekend and send you a
>> final version to approve then. However if you have time now, and want to
>> start, it would make sense as the changes for the editors are only:  icons,
>> w3c conformance and name consistency (were we changed the pattern name to
>> update the tables and user need)
>>
>> So if you do want to start the review, just ignore these items.
>>
>> The edited draft is at
>> https://raw.githack.com/w3c/coga/consistency_checks/content-usable/index.html
>>
>> You can send any feedback to the list. Feel free to read it as HTML or as
>> a word doc or whatever makes reviewing easier for you.
>>
>> Thanks so much
>> Lisa
>>
>