Re: Review notes for Silverlight techniques

Thank you, Michael. This is an enormous editing task.

I'd like WG members to sign up to review different techniques, so we get
complete coverage. We should review all the Silverlight technique in the
next 2 weeks, so we'll be ready for more reviews when the PDF techniques are
ported.

Please pick 3 techniques to review. I have set up a sign-up page at
http://www.w3.org/WAI/GL/wiki/Reviews; please put your name on the items you
are reviewing, so we don't duplicate effort. If you will not be able to
review techniques in the next few weeks, please let me know.

Loretta

On Thu, Mar 10, 2011 at 1:55 PM, Michael Cooper <cooper@w3.org> wrote:

>  All the Silverlight techniques that I know of ready for porting have been
> moved to the Editors' Draft of WCAG 2 Techniques,
> http://www.w3.org/WAI/GL/WCAG20-TECHS/. I anticipate various issues with
> them due to errors on my part, and minor differences between the structure
> in the wiki and the structure we've been using for the other technologies. I
> enhanced our structure a bit to meet what I saw in the wiki but could have
> introduced various subtle errors, even into techniques we haven't touched.
>
> Here are some questions it would be helpful for you to think of as you
> review these. I expect different people will look at different levels of
> detail, but I'm hoping we can get review of all these issues from at least
> somebody. For reference, the set of techniques by number and the wiki page I
> ported them from is included at the bottom of this message.
>
>    - Are there typographical or formatting errors?
>    - Is there missing content?
>     - Are heading levels correct, in the single-page, by-technology, and
>    complete views?
>    - Are the references to success criteria correct?
>    - Are references to related techniques correct?
>    - Are there broken links?
>    - Are there broken images?
>    - Is the alt text of images appropriate?
>    - Do any images require extended descriptions? If so, what should the
>    description be?
>     - Most of the techniques in the wiki had test files / sample files at
>    the bottom. In our other technologies, we've been putting links to such
>    files at the bottom of an example, not at the bottom of the technique as a
>    whole. Is the location of the references to such files appropriate for each
>    technique?
>    - References to test / example files are usually in the form of
>    "...working example of XYZ". Is the verbiage I pulled out of the air for
>    "XYZ" in these links ok? Note it needs to be fairly distinct, not something
>    like "this example", because of the need to have unambiguous link text in
>    views that have all the techniques together.
>    - Do all the test / example files work? I modified some of them
>    slightly to fit into a standard approach.
>    - Is there / should there be downloadable source code for the test /
>    example files? This is what we did for Flash.
>    - Are code samples appropriately formatted? I took them unchanged from
>    the wiki and didn't run any "pretty print" process on them. What would be
>    most useful here is a complete reformatted version, rather than instructions
>    on what needs doing, which is VERY painstaking to implement.
>    - Are test procedures self-consistent and correct? I tweaked them a bit
>    for consistency with our other techniques.
>    - Some techniques (SL5, SL13, SL18, SL30, SL33) have more than one test
>    procedure. Does the implementation of this work?
>
> There are a few things I haven't yet done, in case you notice going
> through:
>
>    - Techniques have pointers to the success criteria / Understanding
>    document, but I haven't added pointers in the Understanding to the new
>    techniques yet. This will need separate review when it's done.
>    - There is diff markup that hasn't been cleared out yet, because I'm a
>    bit nervous of the tool that does this... This won't be seen in the
>    Silverlight techniques, though, because they're all new.
>    - Language-specific terms just have generic emphasis, rather than more
>    appropriate markup / formatting.
>    - Advisory techniques are indicated as such in the XML but this doesn't
>    yet show up in the HTML.
>
> List of techniques to wiki pages:
>
>    - SL1:
>    http://trace.wisc.edu/wcag_wiki/index.php?title=Accessing_Alternate_Audio_Tracks_in_Silverlight_Media
>    - SL2:
>    http://trace.wisc.edu/wcag_wiki/index.php?title=Changing_The_Visual_Focus_Indicator_in_Silverlight
>    - SL3:
>    http://trace.wisc.edu/wcag_wiki/index.php?title=Controlling_Silverlight_MediaElement_Audio_Volume
>    - SL4:
>    http://trace.wisc.edu/wcag_wiki/index.php?title=Declaring_Discrete_Silverlight_Objects_to_Specify_Language_Parts_in_the_HTML_DOM
>    - SL5:
>    http://trace.wisc.edu/wcag_wiki/index.php?title=Defining_a_Focusable_Image_Class_for_Silverlight
>    - SL6:
>    http://trace.wisc.edu/wcag_wiki/index.php?title=Defining_a_UI_Automation_Peer_for_a_Custom_Silverlight_Control
>    - SL7:
>    http://trace.wisc.edu/wcag_wiki/index.php?title=Designing_a_Focused_Visual_State_for_Custom_Silverlight_Controls
>    - SL8:
>    http://trace.wisc.edu/wcag_wiki/index.php?title=Displaying_HelpText_in_Silverlight_User_Interfaces
>    - SL9:
>    http://trace.wisc.edu/wcag_wiki/index.php?title=Handling_Key_Events_to_Enable_Keyboard_Functionality_in_Silverlight
>    - SL10:
>    http://trace.wisc.edu/wcag_wiki/index.php?title=Implementing_a_Submit-Form_Pattern_in_Silverlight
>    - SL11:
>    http://trace.wisc.edu/wcag_wiki/index.php?title=Pausing_or_Stopping_A_Decorative_Silverlight_Animation
>    - SL12:
>    http://trace.wisc.edu/wcag_wiki/index.php?title=Pausing,_Stopping,_or_Playing_Media_in_Silverlight_MediaElements
>    - SL13:
>    http://trace.wisc.edu/wcag_wiki/index.php?title=Providing_A_Style_Switcher_To_Switch_To_High_Contrast
>    - SL14:
>    http://trace.wisc.edu/wcag_wiki/index.php?title=Providing_Custom_Control_Key_Handling_for_Keyboard_Functionality_in_Silverlight
>    - SL15:
>    http://trace.wisc.edu/wcag_wiki/index.php?title=Providing_Keyboard_Shortcuts_that_Work_Across_the_Entire_Silverlight_Application
>    - SL16:
>    http://trace.wisc.edu/wcag_wiki/index.php?title=Providing_Script-Embedded_Text_Captions_for_MediaElement_Content
>    - SL17:
>    http://trace.wisc.edu/wcag_wiki/index.php?title=Providing_Static_Alternative_Content_for_Silverlight_Media_Playing_in_a_MediaElement#User_Agent_and_Assistive_Technology_Support_Notes
>    - SL18:
>    http://trace.wisc.edu/wcag_wiki/index.php?title=Providing_Text_Equivalent_for_Nontext_Silverlight_Controls_With_AutomationProperties.Name
>    - SL19:
>    http://trace.wisc.edu/wcag_wiki/index.php?title=Providing_User_Instructions_With_AutomationProperties.HelpText_in_Silverlight
>    - SL20:
>    http://trace.wisc.edu/wcag_wiki/index.php?title=Relying_on_Silverlight_AutomationPeer_Behavior_to_Set_AutomationProperties.Name
>    - SL21:
>    http://trace.wisc.edu/wcag_wiki/index.php?title=Replacing_A_Silverlight_Timed_Animation_With_a_Nonanimated_Element
>    - SL22:
>    http://trace.wisc.edu/wcag_wiki/index.php?title=Silverlight_and_Browser_Zoom
>    - SL23:
>    http://trace.wisc.edu/wcag_wiki/index.php?title=Using_A_Style_Switcher_to_Increase_Font_Size_of_Silverlight_Text_Elements
>    - SL24:
>    http://trace.wisc.edu/wcag_wiki/index.php?title=Using_AutoPlay_to_Keep_Silverlight_Media_from_Playing_Automatically
>    - SL25:
>    http://trace.wisc.edu/wcag_wiki/index.php?title=Using_Controls_and_Programmatic_Focus_to_Bypass_Blocks_of_Content_in_Silverlight
>    - SL26:
>    http://trace.wisc.edu/wcag_wiki/index.php?title=Using_LabeledBy_to_Associate_Labels_and_Targets_in_Silverlight
>    - SL27:
>    http://trace.wisc.edu/wcag_wiki/index.php?title=Using_Language/Culture_Properties_as_Exposed_by_Silverlight_Applications_and_Assistive_Technologies
>    - SL28:
>    http://trace.wisc.edu/wcag_wiki/index.php?title=Using_Separate_Text-Format_Text_Captions_for_MediaElement_Content
>    - SL29:
>    http://trace.wisc.edu/wcag_wiki/index.php?title=Using_Silverlight_%22List%22_Controls_to_Define_Blocks_that_can_be_Bypassed
>    - SL30:
>    http://trace.wisc.edu/wcag_wiki/index.php?title=Using_Silverlight_Control_Compositing_and_AutomationProperties.Name
>    - SL31:
>    http://trace.wisc.edu/wcag_wiki/index.php?title=Using_Silverlight_Font_Properties_to_Control_Text_Presentation
>    - SL32:
>    http://trace.wisc.edu/wcag_wiki/index.php?title=Using_Silverlight_Text_Elements_for_Appropriate_Accessibility_Role
>    - SL33:
>    http://trace.wisc.edu/wcag_wiki/index.php?title=Using_Well-Formed_XAML_to_Define_a_Silverlight_User_Interface
>    - SL34:
>    http://trace.wisc.edu/wcag_wiki/index.php?title=Using_the_Silverlight_Default_Tab_Sequence_and_Altering_Tab_Sequences_With_Properties
>    - SL35:
>    http://trace.wisc.edu/wcag_wiki/index.php?title=Using_the_Validation_and_ValidationSummary_APIs_to_Implement_Client_Side_Forms_Validation_in_Silverlight
>
>
> --
>
> Michael Cooper
> Web Accessibility Specialist
> World Wide Web Consortium, Web Accessibility Initiative
> E-mail cooper@w3.org <cooper@w3.org>
> Information Page <http://www.w3.org/People/cooper/>
>

Received on Thursday, 10 March 2011 22:24:17 UTC