Skip to content
This repository has been archived by the owner on Jun 30, 2018. It is now read-only.

Provide support issue32 help #118

Closed
wants to merge 3 commits into from

Conversation

jmcsorle
Copy link
Contributor

The original Help issue can be found at the following address: #32

Incorporated feedback on the SC language by removing "information," which was a redundancy in terms. Added glossary terms for cardinal directions, long documents, complex information, and non-numerical value.
The original issue can be found at the following address:
w3c#32
As part of the consensus process, the following sentence was removed from Provide Support (line 828):
"Where an understanding of mathematics is not a primary requirement for using this content, reinforce numbers with non-numerical values." As this SC moves forward, this phrase needs to be reevaluated and discussed with the WCAG group because it specifically addresses the needs of people with dyscalculia.  The original Help issue can be found at the following address:  w3c#32.
@jmcsorle jmcsorle mentioned this pull request Feb 10, 2017
Closed
Copy link
Contributor

@lseeman lseeman left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

please delete "

Context-sensitive help is available.

"

@lseeman
Copy link
Contributor

lseeman commented Feb 13, 2017

Delete the last sentence about context sensitive help.

Copy link
Member

@steverep steverep left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I made a few editorial suggestions. Hopefully they are helpful.

<section class="sc">
<h4>Provide Support</h4>
<p class="conformance-level">AA</p>
<p class="change">Content is provided that helps users understand complex information, long documents, numerical information, relative and cardinal directions (North, South, East, and West), forms and non-standard controls.</p>
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

  • Change "that helps" to "to help". It's a subtle edit, but means the difference between proving you provided help, and proving you actually helped users (which, of course, cannot be guaranteed even with usability testing).
  • Is it necessary to repeat "(north, south, east, and west)" here if it is being defined in the glossary?
  • Change "complex information" to "complex relationships" (see my glossary suggestion)

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks - good ideas

<dt><dfn>correct reading sequence</dfn></dt>
<dt><dfn>complex information</dfn></dt>
<dd>
<p>Something with at least 3 parts where at least 2 of those parts interact with each other in multiple ways.</p>
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Maybe change this to "complex relationships" to make it less abstract and ambiguous? Then a definition like this might work:

connections between at least 3 objects, concepts, or people, where at least 2 of those parts interact with each other in multiple ways

@michael-n-cooper
Copy link
Member

Addressed at 19c91d1. Not all comments on the PR addressed, so further discussion of #32 should review.

Sign up for free to subscribe to this conversation on GitHub. Already have an account? Sign in.
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

4 participants