Re: diffs for review -- wasFwd: How People with Disabilities Use the Web - stories of web users ready for review

On 9/26/2017 8:44 AM, Bakken, Brent wrote:
> [sorry, I responded to the wrong email with this statement yesterday. Was doing two things at once  :) ]
> 
> This is great to have. Thanks for sending the link.
> 
> Of course this will only help if they have a draft version in GitHub and have the link to the mockup of it.

Close. :-) That link can use HTML from old site (doesn't need to be in GitHub), and wiki pages.

As Eric pointed out, that diff can show a lot of extra info.

If page before revision and after revision is in GitHub, can just use that.

So in some cases, doing it in a word processing file might even be better. For example, the Word diffs from Laura/Nic and Vicki were useful.

You can copy the main content from the existing page on the WAI website and create a word file. Then copy the text from the revised page and create a word file. Then do a comparison (Review > Compare > Compare) to get a diff version. That's what I did with the Contacting Orgs page attached. :-)

Best,
~Shawn


> 
> *__*
> 
> Brent A. Bakken
> Director, Accessibility Strategy & Education Services
> Pearson
> 
> 512 202 1087
> brent.bakken@pearson.com <mailto:brent.bakken@pearson.com>
> 
> Learn more at pearson.com <http://pearson.com>
> Pearson
> 
> 
> 
> On Mon, Sep 25, 2017 at 1:33 PM, Shawn Henry <shawn@w3.org <mailto:shawn@w3.org>> wrote:
> 
>     Hi Brent & Sharron,
> 
>     I suggest that Editors provide diff versions for most edits. That way reviewers can choose to focus on the revisions, and not spend much energy on the content that didn't change, if they don't want to.
> 
>     Anyone can create diffs of HTML files from this:
>     http://services.w3.org/htmldiff <http://services.w3.org/htmldiff>
> 
>     Editors could also provide diffs in Word.
> 
>     If you agree, would you communicate to Editors -- and add to the appropriate section(s) under <https://www.w3.org/WAI/EO/wiki/EOWG_Participation_Info#Editing_and_Review_Teams <https://www.w3.org/WAI/EO/wiki/EOWG_Participation_Info#Editing_and_Review_Teams>>
> 
>     Otherwise, happy to talk about it at so-plan on Wed. :-)
> 
>     ~Shawn
> 
> 
>     -------- Forwarded Message --------
>     Subject:        How People with Disabilities Use the Web - stories of web users ready for review
>     Resent-Date:    Fri, 22 Sep 2017 18:09:47 +0000
>     Resent-From: w3c-wai-eo@w3.org <mailto:w3c-wai-eo@w3.org>
>     Date:   Fri, 22 Sep 2017 18:09:17 +0000
>     From:   Sinclair, Norah M <norah.sinclair@amac.gatech.edu <mailto:norah.sinclair@amac.gatech.edu>>
>     To:     Sharron Rush <srush@knowbility.org <mailto:srush@knowbility.org>>, jgreen@visa.com <mailto:jgreen@visa.com> <jgreen@visa.com <mailto:jgreen@visa.com>>, shawn@w3.org <mailto:shawn@w3.org> <shawn@w3.org <mailto:shawn@w3.org>>, Pulido, Jesus <jesus.pulido@amac.gatech.edu <mailto:jesus.pulido@amac.gatech.edu>>
>     CC: shadi@w3.org <mailto:shadi@w3.org> <shadi@w3.org <mailto:shadi@w3.org>>, Sylvie Duchateau <sylvie.duchateau@snv.jussieu.fr <mailto:sylvie.duchateau@snv.jussieu.fr>>, Bakken, Brent <brent.bakken@pearson.com <mailto:brent.bakken@pearson.com>>, EOWG (E-mail) <w3c-wai-eo@w3.org <mailto:w3c-wai-eo@w3.org>>
> 
> 
> 
>     Hello Review Team,
> 
>     Draft revisions of stories of web users are ready for your review and feedback. This resource is the main focus for update of the larger “How People with Disabilities Use the Web.”
> 
>     The goals of the revisions are to:
>     • 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.
> 
>     Drafts are posted on github Revised web stories <https://github.com/w3c/wai-people-use-web/issues/51 <https://github.com/w3c/wai-people-use-web/issues/51>>
> 
>     Please provide your feedback and suggestions by Monday Oct. 2^nd by commenting on the github issue (preferred) or by email. The titles have not been changed other than using a first name, but may need to be changed. Thanks so much for your assistance with this.
> 
>     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 <https://maps.google.com/?q=512+Means+Street+%7C+Suite+250+%7C+Atlanta,+GA+30318&entry=gmail&source=g>
> 
>     phone 404.894.7432 <tel:404.894.7432>
>     www.amacusg.org <http://www.amacusg.org> <http://www.amacusg.org/>
> 
>