RE: Please review: EO Response

+1
Best wishes
E.A.

From: Rachael Bradley Montgomery <rachael@accessiblecommunity.org>
Sent: 10 March 2021 18:29
To: public-cognitive-a11y-tf <public-cognitive-a11y-tf@w3.org>
Subject: Please review: EO Response

CAUTION: This e-mail originated outside the University of Southampton.
Hello,

The draft response to EO is below my signature. Please take a look today and send a +1 if you approve or send changes needed.

Thank you,

Rachael

*** DRAFT RESPONSE ***

Hello,

Thank you for taking the time to conduct a detailed review of Making Content Usable.  We found the comments useful and incorporated many of them. In some cases, we have discussed issues with the EO chairs and staff and within the COGA group to reach resolution. Please see the final resolution to each issue below. Please respond before March 17th if you have any concerns. The most current version of the document is at: https://raw.githack.com/w3c/coga/consistency_checks/content-usable/index.html<https://eur03.safelinks.protection.outlook.com/?url=https%3A%2F%2Fraw.githack.com%2Fw3c%2Fcoga%2Fconsistency_checks%2Fcontent-usable%2Findex.html&data=04%7C01%7Cead%40ecs.soton.ac.uk%7C3d9460612cf44306b9d708d8e3f26c05%7C4a5378f929f44d3ebe89669d03ada9d8%7C0%7C0%7C637509977623176199%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C1000&sdata=d4g3CkOTVqc8Hp%2BFXz%2BIIcrslQegDvKGxy0YBKRHtOg%3D&reserved=0>

205 - Request to "Remove the sections 2.3 Building the User into the Development Process and remove sections 5.1-5.4 of Usability Testing, Focus Groups and Feedback"
The COGA taskforce feels strongly that there is great value in these sections and decided not to remove them. After discussion with EO chairs and reviewing the detailed comments from a follow up survey with EO, we rewrote the content to address the primary areas of concern such as referring to finding people with cognitive disabilities as "easy",  more clearly framing the section. and linking to the EO resource on this topic.  The updated section can be reviewed at https://raw.githack.com/w3c/coga/consistency_checks/content-usable/index.html#Building_in_the_user<https://eur03.safelinks.protection.outlook.com/?url=https%3A%2F%2Fraw.githack.com%2Fw3c%2Fcoga%2Fconsistency_checks%2Fcontent-usable%2Findex.html%23Building_in_the_user&data=04%7C01%7Cead%40ecs.soton.ac.uk%7C3d9460612cf44306b9d708d8e3f26c05%7C4a5378f929f44d3ebe89669d03ada9d8%7C0%7C0%7C637509977623186193%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C1000&sdata=hizq4TUwa9P4ozL0EAf3g03WBV5K%2FKDBNRuqW8oX6PE%3D&reserved=0>

206  For sections 5.5.1-5.5.8., make it clearer that they directly relate to a specific one of the "Objectives".
We tried adding content to make this clearer but found it made reading more difficult. We made sure the section titles map closely to the objective names.

207 Link to additional resources
We have linked to the EO resource on this topic.

208 - Remove appendix B
The COGA taskforce feels strongly that there is great value in this section and decided not to remove it however we trimmed it down, combined it with the business section, and linked to the broader EO resource.  You can view the changes at https://raw.githack.com/w3c/coga/consistency_checks/content-usable/index.html#appendix-considerations-for-different-contexts-and-policies<https://eur03.safelinks.protection.outlook.com/?url=https%3A%2F%2Fraw.githack.com%2Fw3c%2Fcoga%2Fconsistency_checks%2Fcontent-usable%2Findex.html%23appendix-considerations-for-different-contexts-and-policies&data=04%7C01%7Cead%40ecs.soton.ac.uk%7C3d9460612cf44306b9d708d8e3f26c05%7C4a5378f929f44d3ebe89669d03ada9d8%7C0%7C0%7C637509977623196187%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C1000&sdata=KhAuLLq4dJTMyNuJAc3vM0yu3vELImNir07wFMGpycg%3D&reserved=0>

209 - Provide the information in a more consumable way than a single TR doc
COGA will continue working with Shadi and Hidde on the interactive web version. We will leave this issue open for the future.

210 -  Rewrite section 2.1 "How to Use this Document" to provide guidance for designers, developers, and writers on how to use the document.
We have updated this section and added a link to the appendix some members found more helpful.

211 - Move "Following the advice in this document as much as possible will be particularly valuable for Web content and applications that address: ... [list]" to the main part of the Introduction or a separate section.
This has been done.

212 - In the Introduction, add a few sentences that more clearly and succinctly provides guidance on using this document in policy and other contexts
We have made this change. Please see https://raw.githack.com/w3c/coga/consistency_checks/content-usable/index.html#how-to-use-this-document<https://eur03.safelinks.protection.outlook.com/?url=https%3A%2F%2Fraw.githack.com%2Fw3c%2Fcoga%2Fconsistency_checks%2Fcontent-usable%2Findex.html%23how-to-use-this-document&data=04%7C01%7Cead%40ecs.soton.ac.uk%7C3d9460612cf44306b9d708d8e3f26c05%7C4a5378f929f44d3ebe89669d03ada9d8%7C0%7C0%7C637509977623196187%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C1000&sdata=YYU0xfXw%2FjgKeOLJ%2BUUcSn%2FmJlxfWNOYsd9ya8OSA1U%3D&reserved=0>

213 - Summary, Appendix A: Mapping User Needs, Persona and Patterns, Introduction, Objectives
COGA experimented with moving the appendix up but it made the document difficult to read. We instead link to it in How to Use this Document. Please see:  https://raw.githack.com/w3c/coga/consistency_checks/content-usable/index.html#how-to-use-this-document<https://eur03.safelinks.protection.outlook.com/?url=https%3A%2F%2Fraw.githack.com%2Fw3c%2Fcoga%2Fconsistency_checks%2Fcontent-usable%2Findex.html%23how-to-use-this-document&data=04%7C01%7Cead%40ecs.soton.ac.uk%7C3d9460612cf44306b9d708d8e3f26c05%7C4a5378f929f44d3ebe89669d03ada9d8%7C0%7C0%7C637509977623196187%7CUnknown%7CTWFpbGZsb3d8eyJWIjoiMC4wLjAwMDAiLCJQIjoiV2luMzIiLCJBTiI6Ik1haWwiLCJXVCI6Mn0%3D%7C1000&sdata=YYU0xfXw%2FjgKeOLJ%2BUUcSn%2FmJlxfWNOYsd9ya8OSA1U%3D&reserved=0>

214 - Put the Introduction first
We have reworked the introduction per other suggestions. The Abstract, Status and Summary must come before the introduction. The introduction is the first part of the main content. We have added "(Easy to Understand Language)" as part of the Summary header to reduce confusion.

215 - Change "Summary" to something like "Objectives and Overview".
The summary is the easy read portion of this document.  We have added "(Easy to Understand Language)" as part of the Summary header to reduce confusion.

216 -  In the tables, also link the User Stories and Design Patterns
This is one of the last steps in preparing the document and will be done before publication.
218 - Improve readability to have the hanging indent after that images
This is done.

219 - add a subheading such as "Not WCAG Requirements"
The language in the introduction is the result of a great deal of consensus building. We did not change this further.

220 - I had difficulty understanding objectives 1 and 3
After discussion, we addressed this by adding introduction text to clarify each objective rather than changing the objective names.

222 - Please change some persona names so diverse ethnicities are included.
Done. The changes were run by the internationalization group.

223 - QA review and copy edit
We conducted a plain language audit and several editorial reviews of the entire document.

235 - copyedit and consistency edit
We made changes so lists are consistent.

Thank you again for taking the time to make our document better.

The COGA Taskforce
[https://ssl.gstatic.com/ui/v1/icons/mail/images/cleardot.gif]