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

[Blake Henderson]

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-_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
>> _______________________________________________
>> 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
> _______________________________________________
> 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-_mhZE2XgVXIjbkY1vFUI67FrmDOCHAaA_17suE&s=e1NF76V-M1ibG50AyPtecCZB2T5XJJDFlh05kwcQz4c&e=
> List archives at https://urldefense.proofpoint.com/v2/url?u=http-3A__webaim.org_discussion_archives&d=DwIGaQ&c=4rZ6NPIETe-LE5i2KBR4rw&r=XMUuJ_zlJ9I1qg9tP7WLhw&m=CuAn-_mhZE2XgVXIjbkY1vFUI67FrmDOCHAaA_17suE&s=YgNL3NfH-YCZ_TDu2EGoSEEyBxWNaUmUvsF85I6J-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.georgialibraries.org_mailman_listinfo_open-2Dils-2Ddocumentation&d=DwIGaQ&c=4rZ6NPIETe-LE5i2KBR4rw&r=XMUuJ_zlJ9I1qg9tP7WLhw&m=CuAn-_mhZE2XgVXIjbkY1vFUI67FrmDOCHAaA_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-documentation
>
>
> 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-documentation