Re: How People with Disabilities Use the Web resource editing

This is a great approach Norah, just what we were hoping people would be
inspired to do!  Thanks so much, I look forward to your story revision.  I
was not part of the decision to use the form titles and surnames so can't
really comment on what was the thinking there.  Will let Shadi be the guide
on that question.

Thanks very much for your efforts - most appreciated!

Best,
Sharron



On Wed, Aug 2, 2017 at 12:46 PM, Sinclair, Norah M <
norah.sinclair@amac.gatech.edu> wrote:

> 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 <(404)%20894-7432>
> 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> wrote:
>
>> [resending with public archive 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
>>> 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*
>



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