W3C home > Mailing lists > Public > w3c-wai-gl@w3.org > October to December 2008

editorial WCAG techniques review - so far

From: Tim Boland <frederick.boland@nist.gov>
Date: Mon, 17 Nov 2008 14:25:46 -0500
Message-Id: <5.1.1.5.2.20081117142253.00bd5d78@mail.nist.gov>
To: w3c-wai-gl@w3.org

Hi, just some things I found when reviewing the first few techniques (from 
a recent WCAG Techniques Document):

G4 - boxes contain "on this page", "applicabiity", "description", 
"examples", "tests",
G1 in addition has "resources" and "related techniques"

Should the boxes for each technique be consistent even though there are no 
entries under some categories for some
techniques?  Maybe if no content say "to be provided?"

Also, in G1 examples are given subheadings like "Example 1", etc., while in 
G4 examples are bulleted..
consistency issue?

Also, in G1 test procedure you have all "checks" wheras in G4 you have some 
"use" and some "checks"?
Typo - need period after number "5" on G1 test procedure..

G5 Test Procedure uses "determine" rather than "check"?

G8 again uses subheadings for examples like G1 does.. also for G8, what 
about an outcome for step
number 4 in test procedure (only 2 and 3 are mentioned?)

The test procedure for G9 seems inconsistent with the title of the 
technique (actually creating captions)..
the procedure talks about policy and procedure but not if captions are 
actually created (need to have a
"check" in there..)

For G10, "programming" after "Applicability" section needs to be 
capitalized for consistency with
other techniques..  still another variant on "Examples" is used 
here..  repeating "Example" twice as in
"Example 1" and then again "Example 1" following.. also no "Example 2" 
following - inconsistent..?  Here in G10
you have "Resources" and "Related Techniques" with empty content (see 
suggestion previous on this subject)..
Steps 1,3,5 for "test procedure" need ending periods..

Will keep going

Best, Tim Boland NIST

    
Received on Monday, 17 November 2008 19:26:30 GMT

This archive was generated by hypermail 2.2.0+W3C-0.50 : Monday, 7 December 2009 10:47:55 GMT