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

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
>