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

[Remington Steed]

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-_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
> _______________________________________________
> 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

_______________________________________________
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=