Re: 3rd review of the design guided. . objective 4 until the end!

Thank you Roy!!



fantastic!

All the best

Lisa Seeman

http://il.linkedin.com/in/lisaseeman/, https://twitter.com/SeemanLisa





---- On Sun, 19 May 2019 18:37:19 +0300 Roy Ran <ran@w3.org> wrote ----


Hi Lisa,

Thank you for your review, I will add all of those 3 times review
      into main doc as soon.

Best,

Roy

在 2019/5/17 下午11:02, lisa.seeman 写道:




third review of https://raw.githack.com/w3c/coga/design-doc-transfer/design/index.html#pattern-provide-help-with-directions



please submit any comments by the end of Monday.



General comments



The links to old versions are gone. we must compare to
          older versions

Heading levels of failure examples need to be fixed





pattern 5.3 

change

"Pattern: Build forms so that people make less mistakes



Input errors should be automatic corrected (where the

correction is reliable) if suggestions for corrections are

known, the suggestions are provided to the user



In a text field, accept as many formats as possible. For

example accept different formats of phone numbers and
          correct

Input errors automatically

Use an interface were only valid input can be selected

Accept voice prompts for people with a speech impairment

Use the default format of the users location such as
          currency

and temperature

Use autocomplete and personalization of form controls"



to



Pattern: Design forms so that people make less mistakes



Choose a form design that reduces the  chance that the user

will make a mistake. This includes:



- In a text field, accept as many formats as possible. For

example accept different formats of phone numbers and
          correct

Input errors automatically

-Use an interface were only valid input can be selected

-Use autocomplete and personalization of form controls

-Accept voice prompts when supported by the operating
          system

-When possible input errors should be automatic corrected

(where the correction is reliable)

-If suggestions for corrections are known, the suggestions
          are

provided to the user

"



add an editors note: items may be moved to 5.6



how it helps

remove:

" Image of options being restricted to valid inputs



Autocomplete"





pattern 5.4 

change"

Allow the user to check their work before submitting a form
          so

that they can correct any mistakes.Once they have fixed
          their

mistake it should be easy to get back to the place they
          were at

(without redoing extra steps)."



to

"Always allow the user to check their work and  correct any

mistakes.

Once the user has fixed their mistake it should be easy to
          get

back to the place they were at without redoing additional

steps.



pattern 5.5

change "Provide clear instructions up front when
          appropriate that

is clear, concise, and accessible. Ensure labels are also

clear."



to

"Provide clear labels and instructions that are:

-before the field or activity

-clear, concise, and accessible.

"



how it helps:



change "Clear instructions help prevent user errors up
          front. "

to "Clear instructions help prevent user errors"



change "people new to culture" to "people from a diffrent

culture"



pattern 5.6





change editors note to read: this pattern will be reviewed
          with 5.3 to

remove any overlap



pattern 5.7 

I think we can remove the ed not. the standard similar
          when  compared to the others.



remove"



For situations where the absence of a timed event would

significantly change the intended functionality of an

application (e.g., an auction or another real-time event),
          it

is important to ensure that users with disabilities are

properly notified. Notifications should include information

about timed events, and an indication of the duration of
          the

time given. As well, they should include mechanisms clearly

labelled to adjust, extend, or stop the duration of an
          event,

to allow users to fully engage and interact with Web
          content

and functionality. For example, if an e-commerce Web site's

checkout process provides secure credit card transactions,
          the

user is notified of the timeout, and is given at least 120

seconds to extend it. .... Remove intill end of "how it
          helps!

untill "This pattern helps people with a variety of

disabilities including the following:"



add to more details

"For situations where the absence of a timed event would

significantly change the intended functionality of an

application (e.g., an auction or another real-time event),
          it

is important to ensure that users with disabilities are

properly notified. "



delete empty sections



add success example:

"A Web site with sensitive information uses a client-side
          time

limit to help protect users who may step away from their

computers. After a period of inactivity, the Web page asks
          if

the user needs more time. If the user does not respond
          within

120 seconds, a timeout occurs. However when the user logs
          in again all the work is back.



A website  only  times out when sensitive information is
          given (such as

the users credit card information).  The sensitive

information is asked for at the last stage of the process.
          The user is warned that once they give the cedit card
          information they should complete th process quickly as the
          session can time out. After a

period of inactivity, the Web page asks the user to press
          any key for more time. If the user does not respond within 120
          seconds, a

timeout occurs. However when the user comes back and
          logs-in again

all the content is back.



5.9 delete empty bullet points and >



5.10



delete ed note and empty marks



>



add to: Success examples



"

the user can set to change the rout if more then a specific

amount of time is saved. They can add more information such
          as  how many  extra turns

are acceptable for saving 5 minuets. When a new rout is
          find that save time the user is asked if they want to change
          rout, how many extra turns re added and how much time will be
          saved. The user can go back to the original

rout in one touch or command."





pattern 5.11



change:

Checking how safety and security techniques work with a
          wide

range of customized profile including aging, learning and

cognitive disabilities.

Using known techniques to keep sensitive user information
          safe.

Ensuring all users understand known risk.



to:



"Checking how safety and security techniques work with a
          wide

range of customized profile including aging users and users

with learning and cognitive disabilities.

Using known techniques to keep sensitive user information
          safe.

Help all users understand any relevant known risks."





pattern 6.3



change:

"If you can not avoid them, make an easy way to delay and

control interruptions and changes in content, unless they
          are

started by the user or involve an emergency.

"

to:

"when possible , avoid interruptions



If you can not avoid them, make an easy way to 

control interruptions and changes in content, unless they
          are

started by the user or involve an emergency."





pattern 6.4

Provide users with less than five choices on each screen.
          This

can be a simplified version or have extra choices linked
          from

clear and descriptive titles.



to

"

Provide users with  five or less choices on each screen and

remove unnecessary content.



Extra links that do not relate to the main purpose of the
          page

should be limited to the footer section. Extra choices can
          also

be provided using clear and descriptive titles.



This can be provided via a simplified version alternative
          that

is generated in real time from the same code base as the
          main

content.



"

pattern 7.4

change:

"Let people easily reach an operator without going through

multiple steps."



to

"Let people easily reach an operator without:



-memorizing character strings, including remembering digits
          to

select for a short time, or pin numbers

-perform calculations, or

-coping; or

-using their executive function to work out the category of
          the

service they need;

-going through multiple steps.

"



remove ed note (you cna add it as an issue if you
          want!



change:

"Allowing the 0 digit to get to a person, or having the
          first

option "to weight for an person who can help you press 0"
          can

consistently help"



to "



The 0 digit  should be reserved for reaching a person.

Consistently set the first option for each menu to: "to
          weight for an person who

can help you press 0". This can help everyone reach the

support they need."



change"Not important systems might only use the design

requirement bellow (XX)



"



to  "Unimportant systems, that do not affect the users
          health,

safety, money or rights, could only use pattern 7.5"



7.5

change "Each step in a sequential process must contain the

information necessary to allow a user to proceed (and so
          must

not rely on memory from prior steps, and would benefit from
          a

summary of info, or a mechanism for traversing the
          process."

to

"Each step in a sequential process must contain the
          information

necessary to allow a user to proceed. They must rely on
          memory

from prior steps. When useful, provide  a summary of
          information

from previous steps, and a mechanism for traversing the

process.



remove: "Not important systems might only use the design

requirement bellow (XX)"





add the acronym tag to VUI (voice user interfaces)



add ed note : we intend to review this pattern with 7.4 to

check for overlaps





Theme 8.

The user testing and user stories were meant to merge

with the new material not just replace it! please also add
          the

old user testing and user stories.



pattern 8.3

change"Provide explanatory content for complex information
          and

tasks, especially if it is important for successful
          completion

of a task."

to

"Content is provided that helps users understand complex

information"



add the following to "getting started"



"Provide explanatory content for complex information that
          is

important for successful completion of a task including
          tasks

in the real world."





move the content from "more details" to the end of "how it
          helps"



In the more details section copy over the text from

https://w3c.github.io/coga/design/#provide-help-for-complex-

information for:



Sufficient techniques for content relating to numbers and

complex information. (use whichever apply)



and

Sufficient techniques for content with more than 300 words



pattern 8.4

change

"Help is provided help with navigational systems and
          directions."

to 

"Content is provided that helps users understand directions
          and navigational systems.:



The content in more details should be added to the "how it
          helps" section



Remove " Extra help with these ensures navigational systems
          and directions can easily be used without constant reminders
          being needed. Especially if it built in directly to the system
          or directions."





"Consider using sing any standard mechanism "  should be
          "Consider using any standard mechanism "



Heading levels of failure examples need to be fixed







pattern 8.5



change "Provide help for any complex forms, particularly
          when

there are multiple steps, unusual interactions or
          non-standard

controls."



to

"Provide help for any complex forms, particularly when
          there

are multiple steps, unusual interactions, non-standard
          controls

and required feilds that do not support autocomplete.



Add to the end of the "how it helps" section



"Many standard forms controls provide support
          automatically. For example, many fields  can be automatically
          fill it all in the information using autocomplete or
          personlization semantics. Then the user will not make mistakes
          filling it out. 





When you require additional fields and non standard
          controls many users will have difficulty filling it in. Many
          users with disabilities will get the information incorrect or
          be unable to work out how to complete the task. Often this
          results in the task being completely abandoned. In other cases
          the user asks a care giver for help to complete the form or
          work the control. In either case they have not been able to
          complete the task because of their disability."







In the "More Details" section

-delete empty bullet

-change "Brand new controls like date pickers" to "custom
          controls like date pickers"

- add the Sufficient techniques from 8.3.3  at

https://w3c.github.io/coga/design/#provide-help-for-forms-and-

non-standard-controls

-add to the Sufficient techniques : "adding advice to any
          controls that are not complaint with  "html 5 autocomplete". " 



heading levels of failure examples need to be fixed



Technical details

add

On coga github: help.html

wcag issue 32

pull request 118

(frem m https://w3c.github.io/coga/design/#technical-details-29)







(this pattern should be reviewd again when all these
          changes are made)





pattern 8.6



move the content of the  "more detail" to the section "how
          it helps" above



add to success examples

-A phone number, ideally with a feature to automatically
          call via an interoperable Voice over IP specification.

- An email link using the ‘mailto’ protocol with prefilled
          “to” and “subject” fields. Note will not work on all platforms
          or depending of the users mail client



pattern 8.7



8.7.1 How it helps

remove the bullet formatting (the content should not be in
          bullets)



remove the ed note



objective 8



add the first few sections (introduction, user stories and
          user testing) from the google docs from https://docs.google.com/document/d/1aJE2C0FzzzXgydEp0MNGSdDDvUTTsANViUVvciFK36k/edit#heading=h.hj3ovfr7yhr6



(



9.3



remove editors note

remove empty bullet point

remove "/" at end of bullet point

change the to the Sufficient techniques on failure examples





remove the content and the heading "The Internet of Things
          (IoT) and the Web of things."



add to more details the content from  https://w3c.github.io/coga/design/#how-it-helps-42 until the section The Internet of Things (IoT)"

and add to the more details

"

Exceptions:



-When there is a security or safety requirement, these
          API's may be disabled for the relevant field

-If it breaks the main function of the site, such as
          evaluation and testing applications

"



pattern 9.4

add full stop at end of second bullet point



in "more detail" remove empty bullet



add technical references from

https://w3c.github.io/coga/design/#technical-references-3





pattern 9.5



the spacing in the example stops them from making sense

remove "Example taken from adaptable ui personalisation.

aui-action="compose"

A page working with autocorrect" . leave the rest of the
          text.



Add "install a personlization tool bar"



copy technical details from  the google doc at https://docs.google.com/document/d/1aJE2C0FzzzXgydEp0MNGSdDDvUTTsANViUVvciFK36k/edit#heading=h.qf7qfrl7znc4

Received on Sunday, 19 May 2019 16:14:14 UTC