[OPEN-ILS-DOCUMENTATION] [External] Re: Fwd: [WebAIM] Protocol when writing app instructions

Mon Jul 1 11:33:52 EDT 2019

I often use "select" in my documentation. 

But I use it for everything, so there are a lot of "select [word] from dropdown" vs. "select [word] button" vs. "select [word] from menu" etc. 

Clear, but not concise.

Now that I read my own words, am eager to hear better suggestions. . .

Jessica 
Government and Heritage Library
State Library of North Carolina

-----Original Message-----
From: OPEN-ILS-DOCUMENTATION <open-ils-documentation-bounces at list.georgialibraries.org> On Behalf Of Blake Henderson
Sent: Monday, July 01, 2019 11:26 AM
To: open-ils-documentation at list.georgialibraries.org
Subject: [External] Re: [OPEN-ILS-DOCUMENTATION] Fwd: [WebAIM] Protocol when writing app instructions

CAUTION: External email. Do not click links or open attachments unless you verify. Send all suspicious email as an attachment to report.spam at nc.gov<mailto:report.spam at nc.gov>

How about "press"

-Blake-
Conducting Magic
MOBIUS

On 7/1/2019 10:08 AM, Lynn Floyd wrote:
> What about the word "engage"?
>
> Lynn Floyd
> Lfloyd at andersonlibrary.org
> Anderson County Library
> Anderson, SC
>
>
> -----Original Message-----
> From: OPEN-ILS-DOCUMENTATION 
> <open-ils-documentation-bounces at list.georgialibraries.org> On Behalf 
> Of Remington Steed
> Sent: Thursday, June 20, 2019 2:09 PM
> To: Documentation discussion for Evergreen software 
> <open-ils-documentation at list.georgialibraries.org>
> Subject: Re: [OPEN-ILS-DOCUMENTATION] Fwd: [WebAIM] Protocol when 
> writing app instructions
>
> Good question, Jane!  I'm interested to hear ideas of terms to replace "click", but I hope we can avoid "operate".  While that may be inclusive in a technical sense, I think it requires all users to think more like a machine, when obviously our goal is to make the machines (and instructions) serve the users.
>
> Remington
>
> --
> Remington Steed
> Electronic Resources Specialist
> Hekman Library, Calvin College
> http://library.calvin.edu/
>
> -----Original Message-----
> From: OPEN-ILS-DOCUMENTATION 
> <open-ils-documentation-bounces at list.georgialibraries.org> On Behalf 
> Of Jane Sandberg
> Sent: Wednesday, June 19, 2019 8:01 PM
> To: Documentation discussion for Evergreen software 
> <OPEN-ILS-DOCUMENTATION at list.georgialibraries.org>
> Subject: [OPEN-ILS-DOCUMENTATION] Fwd: [WebAIM] Protocol when writing 
> app instructions
>
> Here's an interesting documentation-related discussion happening on another email list I subscribe to.  I know that we have a lot of "click on X" language in our docs.  Should we consider some other term that also includes tapping, hitting Enter, voice control, etc.?
>
> ---------- Forwarded message ---------
> From: Aditya via WebAIM-Forum <webaim-forum at list.webaim.org>
> Date: Wed, Jun 19, 2019 at 4:39 PM
> Subject: Re: [WebAIM] Protocol when writing app instructions
> To: WebAIM Discussion List <webaim-forum at list.webaim.org>
> Cc: Aditya <adityatt at yahoo.com>
>
>
> Similar to “operate” being equivalent to a click/tap, what would be the recommended instruction for executing swipe for a voice over user on iPhone or iPad?
>
> Sent from my iPhone
>
>> On Jun 19, 2019, at 3:48 PM, Steve Green <steve.green at testpartners.co.uk> wrote:
>>
>> Our report writing guidelines say to use the word "operate" for links and buttons rather than "click" because it is independent of the mode of operation, such as clicking, tapping, keyboard operation or voice control. I agree that "select" is definitely not appropriate.
>>
>> Steve Green
>> Managing Director
>> Test Partners Ltd
>>
>>
>>
>> -----Original Message-----
>> From: WebAIM-Forum <webaim-forum-bounces at list.webaim.org> On Behalf 
>> Of Karin Carlson
>> Sent: 19 June 2019 21:35
>> To: webaim-forum at list.webaim.org
>> Subject: [WebAIM] Protocol when writing app instructions
>>
>> Hello, everyone.
>>
>> As an instructional designer with experience working on content for 
>> Microsoft, I've been using the Microsoft style guide wordings when 
>> writing instructions that describe doing something in an application.
>> For example, you click a link or menu, but select a checkbox.
>> Recently, a colleague of mine told me that, to be compliant with 
>> accessibility standards, we should stop using "click" for any 
>> instruction (because it's mouse-centric), and use "select" instead.
>> So, "click the link" would change to "select the link" (To be clear, 
>> I'm not talking about JS events, this is just written instructions, 
>> as you would find in a learning job aid or quick reference.)
>>
>> To me this is 100% wrong, because a) it doesn't map to Microsoft (and
>> other) manual of style; 2) it doesn't describe what you are doing (and I personally believe that everyone, sighted or not, understands what "clicking" a button is, and "selecting" is a different action); and 3) inconsistency is generally not good for UX or for accessibility.
>>
>> 1 - Does anyone know of a reliable resource (like W3C) that has written on this topic? I can't find anything.
>> 2 - Does anyone have personal experience with testing instruction-type material where this has come up?
>>
>> Thanks
>>
>> Karin
>> Karin Carlson, MCT, MSOMS
>> Accessibility Consultant/Trainer
>> instructional Designer
>> Applications Instructor
>> _______________________________________________
>> To manage your subscription, visit
>> https://urldefense.proofpoint.com/v2/url?u=http-3A__list.webaim.org_&
>> d 
>> =DwIGaQ&c=4rZ6NPIETe-LE5i2KBR4rw&r=XMUuJ_zlJ9I1qg9tP7WLhw&m=CuAn-_mhZ
>> E 
>> 2XgVXIjbkY1vFUI67FrmDOCHAaA_17suE&s=e1NF76V-M1ibG50AyPtecCZB2T5XJJDFl
>> h
>> 05kwcQz4c&e=  List archives at
>> https://urldefense.proofpoint.com/v2/url?u=http-3A__webaim.org_discus
>> s 
>> ion_archives&d=DwIGaQ&c=4rZ6NPIETe-LE5i2KBR4rw&r=XMUuJ_zlJ9I1qg9tP7WL
>> h 
>> w&m=CuAn-_mhZE2XgVXIjbkY1vFUI67FrmDOCHAaA_17suE&s=YgNL3NfH-YCZ_TDu2EG
>> o SEEyBxWNaUmUvsF85I6J-0A&e= Address list messages to 
>> webaim-forum at list.webaim.org 
>> _______________________________________________
>> To manage your subscription, visit
>> https://urldefense.proofpoint.com/v2/url?u=http-3A__list.webaim.org_&
>> d 
>> =DwIGaQ&c=4rZ6NPIETe-LE5i2KBR4rw&r=XMUuJ_zlJ9I1qg9tP7WLhw&m=CuAn-_mhZ
>> E 
>> 2XgVXIjbkY1vFUI67FrmDOCHAaA_17suE&s=e1NF76V-M1ibG50AyPtecCZB2T5XJJDFl
>> h
>> 05kwcQz4c&e= List archives at
>> https://urldefense.proofpoint.com/v2/url?u=http-3A__webaim.org_discus
>> s 
>> ion_archives&d=DwIGaQ&c=4rZ6NPIETe-LE5i2KBR4rw&r=XMUuJ_zlJ9I1qg9tP7WL
>> h 
>> w&m=CuAn-_mhZE2XgVXIjbkY1vFUI67FrmDOCHAaA_17suE&s=YgNL3NfH-YCZ_TDu2EG
>> o SEEyBxWNaUmUvsF85I6J-0A&e= Address list messages to 
>> webaim-forum at list.webaim.org
> _______________________________________________
> To manage your subscription, visit 
> https://urldefense.proofpoint.com/v2/url?u=http-3A__list.webaim.org_&d
> =DwIGaQ&c=4rZ6NPIETe-LE5i2KBR4rw&r=XMUuJ_zlJ9I1qg9tP7WLhw&m=CuAn-_mhZE
> 2XgVXIjbkY1vFUI67FrmDOCHAaA_17suE&s=e1NF76V-M1ibG50AyPtecCZB2T5XJJDFlh
> 05kwcQz4c&e= List archives at 
> https://urldefense.proofpoint.com/v2/url?u=http-3A__webaim.org_discuss
> ion_archives&d=DwIGaQ&c=4rZ6NPIETe-LE5i2KBR4rw&r=XMUuJ_zlJ9I1qg9tP7WLh
> w&m=CuAn-_mhZE2XgVXIjbkY1vFUI67FrmDOCHAaA_17suE&s=YgNL3NfH-YCZ_TDu2EGo
> SEEyBxWNaUmUvsF85I6J-0A&e= Address list messages to 
> webaim-forum at list.webaim.org
>
>
> --
> Jane Sandberg
> Electronic Resources Librarian
> Linn-Benton Community College
> sandbej at linnbenton.edu / 541-917-4655
> Pronouns: she/her/hers
> _______________________________________________
> OPEN-ILS-DOCUMENTATION mailing list
> OPEN-ILS-DOCUMENTATION at list.georgialibraries.org
> https://urldefense.proofpoint.com/v2/url?u=http-3A__list.georgialibrar
> ies.org_mailman_listinfo_open-2Dils-2Ddocumentation&d=DwIGaQ&c=4rZ6NPI
> ETe-LE5i2KBR4rw&r=XMUuJ_zlJ9I1qg9tP7WLhw&m=CuAn-_mhZE2XgVXIjbkY1vFUI67
> FrmDOCHAaA_17suE&s=vgH3aA3YHJ-m7CJ1Z6F6OHC1lXV6yELv1t3Hz7vbF3Q&e=
> _______________________________________________
> OPEN-ILS-DOCUMENTATION mailing list
> OPEN-ILS-DOCUMENTATION at list.georgialibraries.org
> http://list.georgialibraries.org/mailman/listinfo/open-ils-documentati
> on
>
>
> Lynn Floyd
> Head of Information Technology
> Anderson County Library
> Anderson, SC
> lfloyd at andersonlibrary.org
>
>
> _______________________________________________
> OPEN-ILS-DOCUMENTATION mailing list
> OPEN-ILS-DOCUMENTATION at list.georgialibraries.org
> http://list.georgialibraries.org/mailman/listinfo/open-ils-documentati
> on

_______________________________________________
OPEN-ILS-DOCUMENTATION mailing list
OPEN-ILS-DOCUMENTATION at list.georgialibraries.org
http://list.georgialibraries.org/mailman/listinfo/open-ils-documentation