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

Hi Lisa,

I have added all your comments to doc, please go ahead.

https://raw.githack.com/w3c/coga/design-doc-transfer/design/index.html

Best,

Roy

在 2019/5/20 下午10:21, Steve Lee 写道:
> Great Roy, please say when you have done so and I'll take another 
> sweep through the document
>
> Steve
>
> On 19/05/2019 16:37, Roy Ran 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 Wednesday, 22 May 2019 10:35:55 UTC