Re: How People with Disabilities Use the Web resource editing

Thanks very much Shadi and Sharron.


>From the resources provided, it looks as though this should be our editing approach:

For most documents:

  *   Simplify & Tersify — Make content simple and brief. Cut words. Cut Sentences.
  *   Bullets & Graphics — Break up passages into bullets when appropriate. Suggest graphics.
  *   Front-loaded Action — Use active voice, and action statements.

Also from Sharron's information, we should attempt to cut the verbiage of the resource in half. I'll attempt to revise one of the stories of web users with this approach and goal in mind and will share with Shadi and Sylvie for feedback. Also, has there been prior discussion regarding the number of stories? Are there too many stories? Would the use of first names be friendlier?


Regards,

Norah


Norah Sinclair
Instructional Technology and User Support Specialist

AMAC Accessibility Solutions and Research Center
Georgia Institute of Technology | College of Design
512 Means Street | Suite 250 | Atlanta, GA 30318

phone 404.894.7432
www.amacusg.org<http://www.amacusg.org/>


________________________________
From: Sharron Rush <srush@knowbility.org>
Sent: Friday, July 28, 2017 10:49 AM
To: Shadi Abou-Zahra
Cc: Sinclair, Norah M; contact@sylvie-duchateau.fr; shawn@w3.org; Bakken, Brent; public-eo-archive@w3.org
Subject: Re: How People with Disabilities Use the Web resource editing

Hey Norah,

Hi Norah and Shadi,

Tanks for collaborating so closely on this, much appreciated!

It may also be useful to know that at today's meeting, we confirmed and agreed that for most resources, our goal will be to cut the verbiage by about half. Of course, that is not a hard and fast rule but a general goal to address the bloat that is currently displayed on WAI and that contributes to how hard it is to find the information we need.

Please look at https://www.w3.org/WAI/EO/wiki/EOWG_Participation_Info#Editors:  and   https://www.w3.org/WAI/EO/wiki/Style#Appendix:_Edit_Examples for our developing approach to this aspect of the editing process.

Thanks so much for your help!

Best,
Sharron

On Thu, Jul 27, 2017 at 3:51 PM, Shadi Abou-Zahra <shadi@w3.org<mailto:shadi@w3.org>> wrote:
[resending with public archive public-eo-archive@w3.org<mailto:public-eo-archive@w3.org> in copy]

Hi Norah,

Thanks so much for taking this initiative!

I look forward to working with you on this. I signed up because I have been the primary editor for this resource for the past several years, and want to help with the transition to the new primary editor(s).

This document goes way back [1, 2]. I took over editing in 2009, where we revised it into a multi-page resource [3, 4]. Last year we moved it to GitHub [5, 6], and made a quick update to better address mobile.

[1] https://www.w3.org/WAI/EO/Drafts/PWD-Use-Web/
[2] https://www.w3.org/WAI/EO/Drafts/PWD-Use-Web/changelog.html
[3] https://www.w3.org/WAI/intro/people-use-web/
[4] https://www.w3.org/WAI/EO/changelogs/cl-PWD-Use-Web.html
[5] https://w3c.github.io/wai-people-use-web/Overview.html
[6] https://github.com/w3c/wai-people-use-web

There are only a few open issues in GitHub [6] which were left to this next iteration. Some of these are minor edits but others relate to the overall information and interaction design, and cross-linking between them. We agreed to address these together with the WAI site redesign. I think there were some ideas from the site redesign team for a complete refactoring of this resource, but I'm not up-to-date on these. I think it may be worthwhile to get on a call with them, if these suggestions are still current. I'm curious how they envision the new architecture.

Also, there is a GitHub issue relating to how cognitive and learning disabilities are addressed in this resource. On the one hand, this has been an on-going issue throughout the lifetime of this resource -- we want to introduce the different types of disabilities to people who are new to the topic, so inadvertently end up creating (rather medical) categories which is kind of contrary to the universal design approach that we are suggesting elsewhere in the resource. I think we need to revisit the terminology and language used to describe all disabilities (not only cognitive and learning disabilities) because these changed over time. Maybe we also find an alternative approach altogether.

I hope this is useful background on where we are and what I think the key issues are, but don't hesitate if you have more questions. I would be happy to get on the phone with you for further discussion too.

Best,
  Shadi


On 26/07/2017 20:04, Sinclair, Norah M wrote:
Hi Shadi and Sylvie,


I'm reaching out to begin discussing the editing approach and process for the resource we will be co-editing, "How People with Disabilities Use the Web".


Shadi, I know you have extensive experience editing this particular resource. Do you have a good idea of the type of restructuring that is needed? Do you have previous requirements documents or notes from recent discussions on changes to be made? In general, what are your thoughts on the best approach to this resource?


Thanks very much,

Norah


Norah Sinclair
Instructional Technology and User Support Specialist

AMAC Accessibility Solutions and Research Center
Georgia Institute of Technology | College of Design
512 Means Street | Suite 250 | Atlanta, GA 30318

phone 404.894.7432<tel:404.894.7432>
www.amacusg.org<http://www.amacusg.org><http://www.amacusg.org/>


--
Shadi Abou-Zahra - http://www.w3.org/People/shadi/
Accessibility Strategy and Technology Specialist
Web Accessibility Initiative (WAI)
World Wide Web Consortium (W3C)



--
Sharron Rush | Executive Director | Knowbility.org | @knowbility
Equal access to technology for people with disabilities