WebAIM - Web Accessibility In Mind

E-mail List Archives

Thread: Protocol when writing app instructions

for

Number of posts in this thread: 7 (In chronological order)

From: Karin Carlson
Date: Wed, Jun 19 2019 2:35PM
Subject: Protocol when writing app instructions
No previous message | Next message →

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

From: Steve Green
Date: Wed, Jun 19 2019 2:48PM
Subject: Re: Protocol when writing app instructions
← Previous message | Next message →

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 < = EMAIL ADDRESS REMOVED = > On Behalf Of Karin Carlson
Sent: 19 June 2019 21:35
To: = EMAIL ADDRESS REMOVED =
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

From: Aditya
Date: Wed, Jun 19 2019 5:39PM
Subject: Re: Protocol when writing app instructions
← Previous message | Next message →

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 < = EMAIL ADDRESS REMOVED = > 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 < = EMAIL ADDRESS REMOVED = > On Behalf Of Karin Carlson
> Sent: 19 June 2019 21:35
> To: = EMAIL ADDRESS REMOVED =
> 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
> > > > > > >

From: Steve Green
Date: Thu, Jun 20 2019 4:52AM
Subject: Re: Protocol when writing app instructions
← Previous message | Next message →

It depends on the purpose of the swipe. Bear in mind that Voiceover users on mobile devices may be using a keyboard for input and control as well as or instead of the touchscreen.

Steve


-----Original Message-----
From: WebAIM-Forum < = EMAIL ADDRESS REMOVED = > On Behalf Of Aditya via WebAIM-Forum
Sent: 20 June 2019 00:39
To: WebAIM Discussion List < = EMAIL ADDRESS REMOVED = >
Cc: Aditya < = EMAIL ADDRESS REMOVED = >
Subject: Re: [WebAIM] Protocol when writing app instructions

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 < = EMAIL ADDRESS REMOVED = > 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 < = EMAIL ADDRESS REMOVED = > On Behalf Of
> Karin Carlson
> Sent: 19 June 2019 21:35
> To: = EMAIL ADDRESS REMOVED =
> 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
> > > archives at http://webaim.org/discussion/archives
> > > > archives at http://webaim.org/discussion/archives
>

From: Jim Homme
Date: Thu, Jun 20 2019 10:21AM
Subject: Re: Protocol when writing app instructions
← Previous message | Next message →

Hi,
I'm pretty sure that if you want a swipe to get from VoiceOver to an app that this will not happen unless the user employs a special gesture on VoiceOver. This is because VoiceOver uses swipes for its own purposes. If there is a way to do the same thing in the app with a tap gesture, that will always work.

Thanks.

Jim



=========Jim Homme
Digital Accessibility
Bender Consulting Services
412-787-8567
https://www.benderconsult.com/our%20services/hightest-accessible-technology-solutions

-----Original Message-----
From: WebAIM-Forum < = EMAIL ADDRESS REMOVED = > On Behalf Of Aditya via WebAIM-Forum
Sent: Wednesday, June 19, 2019 7:39 PM
To: WebAIM Discussion List < = EMAIL ADDRESS REMOVED = >
Cc: Aditya < = EMAIL ADDRESS REMOVED = >
Subject: Re: [WebAIM] Protocol when writing app instructions

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 < = EMAIL ADDRESS REMOVED = > 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 < = EMAIL ADDRESS REMOVED = > On Behalf Of
> Karin Carlson
> Sent: 19 June 2019 21:35
> To: = EMAIL ADDRESS REMOVED =
> 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
> > > archives at http://webaim.org/discussion/archives
> > > > archives at http://webaim.org/discussion/archives
>

From: Aditya
Date: Thu, Jun 20 2019 10:32AM
Subject: Re: Protocol when writing app instructions
← Previous message | Next message →

Yes, there is a way to swipe using voiceover - double tap and hold, and swipe - This is equivalent to swiping on an element.

But would you say "swipe" in the instruction or something else.?
Like, would you say "tap to select" or "double tap to select" as an instruction for screen reader user?
If it's the former, we can say "swipe for next".


Sent from my iPhone

> On Jun 20, 2019, at 11:21 AM, Jim Homme < = EMAIL ADDRESS REMOVED = > wrote:
>
> Hi,
> I'm pretty sure that if you want a swipe to get from VoiceOver to an app that this will not happen unless the user employs a special gesture on VoiceOver. This is because VoiceOver uses swipes for its own purposes. If there is a way to do the same thing in the app with a tap gesture, that will always work.
>
> Thanks.
>
> Jim
>
>
>
> =========> Jim Homme
> Digital Accessibility
> Bender Consulting Services
> 412-787-8567
> https://www.benderconsult.com/our%20services/hightest-accessible-technology-solutions
>
> -----Original Message-----
> From: WebAIM-Forum < = EMAIL ADDRESS REMOVED = > On Behalf Of Aditya via WebAIM-Forum
> Sent: Wednesday, June 19, 2019 7:39 PM
> To: WebAIM Discussion List < = EMAIL ADDRESS REMOVED = >
> Cc: Aditya < = EMAIL ADDRESS REMOVED = >
> Subject: Re: [WebAIM] Protocol when writing app instructions
>
> 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 < = EMAIL ADDRESS REMOVED = > 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 < = EMAIL ADDRESS REMOVED = > On Behalf Of
>> Karin Carlson
>> Sent: 19 June 2019 21:35
>> To: = EMAIL ADDRESS REMOVED =
>> 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
>> >> >> archives at http://webaim.org/discussion/archives
>> >> >> >> archives at http://webaim.org/discussion/archives
>> >
> > > > > > >

From: Jim Homme
Date: Thu, Jun 20 2019 10:38AM
Subject: Re: Protocol when writing app instructions
← Previous message | No next message

Hi,
If the instructions are specifically for VoiceOver users, I would tell them to double tap then hold, then swipe. I would not assume that they know the pass through gesture.

Jim



=========Jim Homme
Digital Accessibility
Bender Consulting Services
412-787-8567
https://www.benderconsult.com/our%20services/hightest-accessible-technology-solutions

-----Original Message-----
From: WebAIM-Forum < = EMAIL ADDRESS REMOVED = > On Behalf Of Aditya via WebAIM-Forum
Sent: Thursday, June 20, 2019 12:32 PM
To: WebAIM Discussion List < = EMAIL ADDRESS REMOVED = >
Cc: Aditya < = EMAIL ADDRESS REMOVED = >
Subject: Re: [WebAIM] Protocol when writing app instructions

Yes, there is a way to swipe using voiceover - double tap and hold, and swipe - This is equivalent to swiping on an element.

But would you say "swipe" in the instruction or something else.?
Like, would you say "tap to select" or "double tap to select" as an instruction for screen reader user?
If it's the former, we can say "swipe for next".


Sent from my iPhone

> On Jun 20, 2019, at 11:21 AM, Jim Homme < = EMAIL ADDRESS REMOVED = > wrote:
>
> Hi,
> I'm pretty sure that if you want a swipe to get from VoiceOver to an app that this will not happen unless the user employs a special gesture on VoiceOver. This is because VoiceOver uses swipes for its own purposes. If there is a way to do the same thing in the app with a tap gesture, that will always work.
>
> Thanks.
>
> Jim
>
>
>
> =========> Jim Homme
> Digital Accessibility
> Bender Consulting Services
> 412-787-8567
> https://www.benderconsult.com/our%20services/hightest-accessible-techn
> ology-solutions
>
> -----Original Message-----
> From: WebAIM-Forum < = EMAIL ADDRESS REMOVED = > On Behalf Of
> Aditya via WebAIM-Forum
> Sent: Wednesday, June 19, 2019 7:39 PM
> To: WebAIM Discussion List < = EMAIL ADDRESS REMOVED = >
> Cc: Aditya < = EMAIL ADDRESS REMOVED = >
> Subject: Re: [WebAIM] Protocol when writing app instructions
>
> 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 < = EMAIL ADDRESS REMOVED = > 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 < = EMAIL ADDRESS REMOVED = > On Behalf
>> Of Karin Carlson
>> Sent: 19 June 2019 21:35
>> To: = EMAIL ADDRESS REMOVED =
>> 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
>> >> >> archives at http://webaim.org/discussion/archives
>> >> >> >> archives at http://webaim.org/discussion/archives
>> >
> > > archives at http://webaim.org/discussion/archives
> > > > archives at http://webaim.org/discussion/archives
>