View source for UAAG review December 2013

Nav: [[Main Page|EOWG wiki main page]]


 '''This file is protected (locked for editing) to provide a stable reference.'''
 <span style="color:#585858;">''(EOWG: This is an archive of previous comments. Put new comments in the [[UAAG review]] page.)''</span>


__TOC__


 '''This file is protected (locked for editing) to provide a stable reference.'''
 <span style="color:#585858;">''(EOWG: This is an archive of previous comments. Put new comments in the [[UAAG review]] page.)''</span>


Drafts:
* [http://www.w3.org/TR/UAAG20/ UAAG 2.0]
* [http://www.w3.org/TR/Implementing-UAAG20/ Implementing UAAG 2.0]
* (also, fyi [http://www.w3.org/WAI/mobile/UAAGexamples Mobile Accessibility Examples from UAAG])

Previous comments:
[[UAAG review June 2013]]

 Note: These comments are from individuals and have '''not''' been reviewed by all EOWG participants.

==UAAG==

===Overall===
<ul>
<li style="padding-bottom:0.5em;">Congrats on getting to this stage with the technical material! It would be good to re-look at the abstract and intro now. A few rough notes are below, although I haven't pointed out all areas that I think need work. <span style="color:#808080;">{Shawn}</span></li>
</ul>

===[http://www.w3.org/TR/UAAG20/#abstract Abstract]===
<ul>
<li style="padding-bottom:0.5em;">I think the abstract needs editing to be clearer, more direct, and simpler.<span style="color:#808080;">{Shawn}</span></li>

<li style="padding-bottom:0.5em;">'''Current text:''' "The "User Agent Accessibility Guidelines 2.0" (UAAG 2.0) is part of a series of accessibility guidelines published by the W3C Web Accessibility Initiative (WAI)."<br/>
'''Suggested edit:''' "UAAG is introduced in the [http://www.w3.org/WAI/intro/uaag User Agent Accessibility Guidelines (UAAG) Overview]."<br/>
<span style="color:#808080;">(This comment was made [http://lists.w3.org/Archives/Public/public-uaag2-comments/2010Jul/0000.html July 2010] and [http://lists.w3.org/Archives/Public/public-uaag2-comments/2013Sep/0000.html September 2013].){Shawn}</span></li>

<li style="padding-bottom:0.5em;">Last sentence of second paragraph is not clear. I don't really understand what it is for. <blockquote>"Technologies not addressed directly by UAAG 2.0 (e.g. assistive technologies for braille rendering) will be essential to ensuring Web access for some users with disabilities.</blockquote><span style="color:#808080;">{Sylvie, 13 December 2013}</span></li>

</ul>

===Status of this Document===
<ul>
<li style="padding-bottom:0.5em;">'''Location:''' Under "May be Superseded", first paragraph, third sentence, (two instances). <br />'''Current wording:''' "W3C" acronym expansion "the World Wide Web Consortium", which results in the phrases "A list of current the World Wide Web Consortium publications" and "report can be found in the the World Wide Web Consortium technical reports". <br />'''Suggested revision:''' Either remove "the" from the acronym expansion, leaving just "World Wide Web Consortium", or remove the acronym expansion completely. <br />'''Rationale:''' First option is more accurate, second option because the acronym "W3C" is more recognizable than its expansion (and faster to hear). <br />'''Note:''' There are other instances in the document ... a code search for 'title="the World ..."' should find them all. <span style="color:#808080;">{Bim}</span>
<ul><li>Agree <span style="color:#808080;">{Sharron 11 December}</span></li>
</ul></li>
</ul>

===Overview===
<ul>
<li style="padding-bottom:0.5em;">'''Location:''' 3rd sentence<br />
'''Current wording:''' ...have control over their environment for accessing the web. <br />
'''Suggested revision:''' ...have equal control over the environment they use to access the web.<br /> 
'''Rationale:''' No one has full "control over their environment," but all should have the same degree of control <span style="color:#808080;">{Sharron, 11 December}</span></li>
<li style="padding-bottom:0.5em;">'''Location:''' Next to last sentence<br />
'''Current wording:''' Although author preferences are important, UAAG 2.0 includes requirements to override certain author preferences when the user would not otherwise be able to access that content. <br />
'''Suggested revision:''' Omit<br /> 
'''Rationale:''' Seems like a non sequitur. Don't understand why that aspect of UAAG is particularly called out, seems a distraction.   <span style="color:#808080;">{Sharron, 11 December}</span></li>
<li style="padding-bottom:0.5em;">Needs editing. For example "Improving accessibility means considering a wide range of disabilities." needs to be stronger. <br />These include visual, auditory, physical, speech, cognitive, language, learning, neurological disabilities, and disabilities related to aging." &mdash; consider using updated WAI wording: including auditory, cognitive, neurological, physical, speech, and visual disabilities. <br />"The UAWG expects that software that satisfies the requirements of UAAG 2.0 will be more flexible, manageable, extensible, and beneficial for a broad range of users." -- Why is this in the normative guidelines?<span style="color:#808080;">{shawn}</span></li>
</ul>

===UAAG 2.0 Layers of Guidance===
<ul>
<li style="padding-bottom:0.5em;">"Each success criterion is assigned a level. The levels are designed to meet the needs of different groups and different situations: A (low, or basic, conformance), AA (recommended conformance), and AAA (highest conformance).' uses different terminology than the Levels sections, which say: "A (basic), AA (recommended), and AAA (advanced)" <span style="color:#808080;">{shawn}</span></li>
<li style="padding-bottom:0.5em;">In the paragraph explaining the principles, what about adding a link to Web Content Accessibility Guidelines 2.0. It would allow the reader to go to WCAG if they want to look at WCAG's principles. <br />Related text: <blockquote>Principles 1, 2, and 3 are parallel to Web Content Accessibility Guidelines (WCAG) 2.0. </blockquote><span style="color:#808080;">{Sylvie, 13 December}</span></li>
</ul>

===Levels of Conformance===
<ul>
<li style="padding-bottom:0.5em;">This section jumps around. The heading is "Levels of Conformance" but only the first section is about conformance. See [http://www.w3.org/WAI/EO/wiki/UAAG_review#Levels_of_Conformance_.28Implementing.29 levels comments on Implementing below]. Maybe this section should stay "Levels of Conformance" and contain only the following. <span style="color:#808080;">{Shawn}</span></li>
</ul>
<div style="border: solid orange 3px; padding: 15px;">
<p style="padding-bottom:0; margin-bottom:0">User agents can conform to UAAG 2.0 at one of three conformance
   levels: A (basic), AA (recommended), and AAA (advanced). <span class="techs-only">The three levels of UAAG 2.0 conformance are based on the corresponding level designations (A, AA, or AAA) of the individual success criteria (i.e., specific requirements). The user agent can conform to a level by meeting the success criteria of that level and the levels below it.</span></p>
<ul style="padding-top:0; margin-top:0">
   <li>Level A conformance: The user agent complies with all applicable level A success criteria. </li>
   <li>Level AA conformance: The user agent complies with all applicable level A and AA success criteria. </li>
   <li>Level AAA conformance: The user agent complies with all applicable level A, AA, and AAA success criteria. </li>
</ul>
<p>For details about what each level represents, how the levels were determined, and how user agent developers and managers can use the levels for prioritizing accessibility improvements and designing user interfaces, <strong>see &lt;Level A, A, AAA in Implementing UAAG&gt;</strong>.</p>
</div>

===UAAG 2.0 Guidelines===
<ul>
<li style="padding-bottom:0.5em;">'''Location:''' 1st and only sentence sentence<br />
Current wording: The guidelines, success criteria, their notes, and the conformance applicability notes are normative. Guideline summaries are informative.<br />
'''Question:''' is there a reason why "normative" is not linked to a definition and "informative" is? Or is it an oversight? <span style="color:#808080;">{Sharron, 11 December}</span></li>

<li style="padding-bottom:0.5em;">'''Location:''' UAAG 2.0 Conformance Applicability Notes, item 3<br />
Current wording: RFC 2119 language not used<br />
'''Comment:''' Suggest a link from "RFC 2119" to a glossary item<br />
<span style="color:#808080;">{Howard, 12 December}</span></li>

<li style="padding-bottom:0.5em;">'''Location:''' Summary item 1.1.4<br />
Current wording: It's recommended that the user can configure the caption text and that text or sign language alternative cannot obscure the video or the controls (1.1.4).<br />
'''Comment:''' I'm not sure if this means caption text should not be configurable to obscure the video or controls.<br />
'''Suggested wording:''' It's recommended that the user can configure the caption text but that text or sign language alternative cannot be configured to obscure the video or the controls (1.1.4).
<span style="color:#808080;">{Howard, 12 December}</span>
<ul>
<li>I don't like "but" in that sentence. I started to suggest a different edit, but then when I went and looked at the SC and the summary, they seem to be out of synch, so I added the comment below rather than working on a sentence that will likely change anyway.<span style="color:#808080;">{Shawn}</span></li>
</ul></li>
<li style="padding-bottom:0.5em;">'''Location:''' [http://www.w3.org/TR/2013/WD-UAAG20-20131107/Overview.html#gl-access-alternative-content Guideline 1.1] Summary<br />
'''Comment:''' The summary does not match the success criteria.<br />
<span style="color:#808080;">{Shawn}</span>
</li>
</ul>

==Implementing UAAG==

===Overall (Implementing)===
<ul>
<li style="padding-bottom:0.5em;">The document is called "Implementing UAAG" however it seems to provide very little specific guidance on actually implementing UAAG technically. Instead it provides information on how people with disabilities use the requirements of UAAG. Thus the title seems very misleading -- that the doc will provide something that it does not. It seems it would be better titled "Understanding UAAG".  <span style="color:#808080;">{Shawn}</span></li>
<li style="padding-bottom:0.5em;">comment <span style="color:#808080;">{name}</span></li>
</ul>

===Levels of Conformance (Implementing)===

<ul>
<li style="padding-bottom:0.5em;">'''Current wording:''' "Levels of Conformance" (heading) <br />
'''Suggested revision:''' "Levels A, AA, AAA"<br />
'''Rationale:''' This section is broader than conformance -- it's about the level of each SC, how they were determined, what they mean, and how UA developers can use them. <span style="color:#808080;"> {Shawn}</span></li>

<li style="padding-bottom:0.5em;">I think it's good that you moved most of the levels info to [http://www.w3.org/TR/2013/WD-IMPLEMENTING-UAAG20-20131107/#intro-conf-levels Implementing]. I suggest the following restructuring of the section for flow and to focus on what most readers will be interested in -- that is, what the levels mean (not how you determined them) and how they can be used. <span style="color:#808080;">(Follow up to [http://lists.w3.org/Archives/Public/public-uaag2-comments/2013Sep/0001.html sept 2013 comment].) {Shawn}</span></li>
</ul>

<div style="border: solid orange 3px; padding: 15px;">
<p style="padding-bottom:0; margin-bottom:0">User agents can conform to UAAG 2.0 at one of three conformance
   levels: A (basic), AA (recommended), and AAA (advanced). <span class="techs-only">The three levels of UAAG 2.0 conformance are based on the corresponding level designations (A, AA, or AAA) of the individual success criteria (i.e., specific requirements). The user agent can conform to a level by meeting the success criteria of that level and the levels below it.</span></p>
<ul style="padding-top:0; margin-top:0">
   <li>Level A conformance: The user agent complies with all applicable level A success criteria. </li>
   <li>Level AA conformance: The user agent complies with all applicable level A and AA success criteria. </li>
   <li>Level AAA conformance: The user agent complies with all applicable level A, AA, and AAA success criteria. </li>
</ul>
<p style="padding-bottom:0; margin-bottom:0">The level designations of the individual success criteria balance the needs of people with disabilities with user agent implementation difficulty. (Specific factors that were considered in  determining the level of each success criterion include: severity of impact to users; inconvenience to other users, including users with other disabilities; current implementations; difficulty of implementation; and size of scope.[@@ &quot;size of scope&quot; needs to be explained.]) Generally:</p>
<ul style="padding-top:0; margin-top:0">
   <li><strong>Level A</strong> success criteria
      address aspects of user agents that:
      <ul>
         <li>can block some people with disabilities from getting information or accomplishing a task, and/or</li>
         <li>are relatively easy for developers to implement or are common in the existing user agents.</li>
      </ul>
   </li>
   <li><strong>Level AA</strong> success criteria
      
      address aspects of user agents that:
      <ul>
         <li>can cause difficulty for some people with disabilities in getting information or accomplishing a task (including tasks causing excessive fatigue), and/or</li>
         <li>may be more difficult for developers to implement. </li>
      </ul>
   </li>
   <li><strong>Level AAA</strong> success criteria
      
      address aspects of user agents that:
      <ul>
         <li>improve accessibility or reduces fatigue for some people with disabilities, and/or,</li>
         <li>may be very difficult for developers to implement.</li>
      </ul>
   </li>
</ul>
<p style="padding-bottom:0; margin-bottom:0">The level designation of individual success criteria is based on the the overall situation considering all disabilities and all user agents. Because of the wide variety of disabilities and user agents, the level designations might not match specific circumstances. Even user agents that conform at the highest level (AAA) may
   not be accessible to individuals with all types, degrees, or combinations of
   disability. </p>
<h3>Using Levels</h3>
<p style="padding-bottom:0; margin-bottom:0">Developers of user agents may want to use the levels to:</p>
<ul style="padding-top:0; margin-top:0">
   <li>Help prioritize accessibility improvements to their projects, giving more weight to the level A and AA success criteria.</li>
   <li>Help decide how to provide accessibility functionality in the user interface, for example, putting Level A functionality in a toolbar, Level AA in the main preference area, and Level AAA in an &quot;Advanced settings&quot; dialog box.</li>
</ul>

</div>