W3C home > Mailing lists > Public > w3c-wai-gl@w3.org > April to June 2007

"consistency" (and other) review of 3.2.1-3.2.5 - my action item

From: Tim Boland <frederick.boland@nist.gov>
Date: Mon, 30 Apr 2007 08:52:38 -0400
Message-Id: <5.1.1.5.2.20070430083612.01ff9570@mailserver.nist.gov>
To: w3c-wai-gl@w3.org

Following is my review of 3.2.1 through 3.2.5 (my action item) for 
consistency and other aspects.   There are a lot of comments/questions 
included.   My apologies for maybe "going beyond" my original assignment in 
this review.   Not all of these need to be investigated right now..  Also
apologies for lateness - I had an Authoring Tools f2f meeting last week, so 
did this over the
weekend..

Thanks and best wishes
Tim Boland NIST

----------------------------------------

SUMMARY:

   In an overall consistency check,
I found that all the links worked, and the definitions were consistent with 
those same definitions
in the guidelines.  I have a meta-comment on the references for the various 
techniques (G61, H11,
etc.) - these references are not semantic or intuitive.  Perhaps the 
labelling of techniques
could be more intuitive, as in: G107, if the technique applies to SC3.2.1 
(or even "Gfocus" (for example), to give
more semantic content, and allow querying techniques on a particular 
subject)..  Just a thought..


In "Understanding" document, for "Intent of Guideline 3.2" section,
first paragraph, maybe we should add the word "resultant" before "behavior" 
in this SC if this is
what we mean, as in, "the resultant behavior"?  Do we want to insert "Web" 
between "different"
and "pages", as in "different Web pages", and insert "similar" between "if" 
and "components", so
that the clause would read "if similar components"?  For the second 
paragraph, do we want to insert
"across a set of Web pages" between "layout" and "makes", so that the 
clause would read "a
consistent layout across a set of Web pages"?  Also, do we want to insert 
"in expected locations"
after "components", so that clause would read "components in expected 
locations"?  Also,
replace "an area" with "a specific area"?

---------------------------------------------------------------------------

3.2.1

  the SC looks OK, and the "Intent of this SC" section looks OK..

Example 1: add "Web" before "page", and what are "jump" 
destinations?  Also, "it" will jump?
What is "it"?  Should we replace the word "screen" with "page" for 
consistency, or leave it alone?

Example 2: add "web" before "page"

Technique G107 - Does this technique really apply to "all" 
technologies?  That's a pretty expansive claim..
Also, do we need a definition for "activate", or do we understand exactly 
what that means, as
opposed to "focus"?  For the description, I would restate end of first 
sentence as "a method
that is predictable by the user for activation".

Technique F52 - in description, put "Web" in front of "page" where it 
occurs, for consistency.  In the third
sentence, I would say "describe resultant behavior"..  Also, do we want to 
give the user the option
not to open the new page if the instructions are confusing, or is that 
already covered?

Technique F55 -OK

---------------------------------------------------------

3.2.2

for the SC, do we need to define "setting"?  Is this the same as 
"configuration" or
"property"?  Also, do we want to say "the resultant behavior" instead of 
just "the behavior"?

In the "How to Meet SC3.2.2" section, do we want to say "the resultant 
behavior" instead of just
"the behavior"?  For the definition of "change of context", what is the 
definition of "meaning"
of the Web page?  This seems somewhat subjective to me, particulary if this 
definition is
normative.  For the "Intent of this SC" section, I'm not sure that the 
phrase "entering date
or selecting from a control" is entirely consistent with "setting of any 
user interface component
  (the language of the SC itself)?  Also, later on, do we want to say 
"clear in advance" rather than just
"clear"?   For the "benefits of 3.2.2" section, first bullet, do we want to 
say "making the behavior of
interactive content" more predictable?  For the second bullet, do we want 
to say at the end of
the first sentence "navigating a site if notified of changes 
beforehand".  In the subbullet of
the second bullet, rewrite as "context change, such as a new window popping 
up, has occurred"?
For the third bullet, do we want to restate as "some individuals with low 
vision and with reading
  and intellectual disabilities, as well as individuals who have 
difficulty.."?  Individuals who
have low vision may also have difficulty interpreting visual cues, so I'm 
not sure that the groupings
as stated are mutually exclusive..

For "Sufficient Techniques", number one, after G80, where are the 
"technology-specific techniques
listed below"?  I could not find them..  Also, should we use "following" 
rather than "below"?
It seems that we could combine the "hiding and showing" techniques into one 
technique, since one
applies to a radio element and one applies to a select element (we use 
radio button in other places
  - consistent terminology?)

In the "Examples of SC3.2.2" section, first bullet, say "the user selects 
the radio button for meeting",
and say "additional fields appear if the reminder button.."?  Put a comma 
between "same" and "the?
Say "the basic context remains the same for the user"?  Also, what exactly 
is the "basic context"?
Opposed to what?  I'm somewhat confused by this term..  For the second 
bullet, spell out "5" to say
"five"?  Also restate as "Humor tab, a short account of"..  Is this second 
bullet an example of a "change of context",
or the "same context"?   This isn't stated anywhere in the example..  Also, 
is the "expected behavior"
of a tab panel user interface obvious or stated explicitly to the user in 
advance?  Finally, maybe
replace "below" with "following"?  For the third bullet, say "enters" 
instead of "enter"?
Is this third bullet an example of a "change of context",
or the "same context"?   This isn't stated anywhere in the example.. Also, 
in the last sentence,
restate as "behavior of these phone number fields"?

Technique G80 - for Example 1, maybe restate as "a submit button that 
causes a change of context
is used for each form"?  For step 2 of Tests, add "has a submit button at 
the end of the form"?

Technique G13 - Example 1, number one, say "Web page", also move "precede 
the buttons" to the end
of the sentence.  For the first bullet of tests procedure, is it always 
obvious in advance
without additional explanation that changing a setting will change the context?

Technique H32 - Tests procedure number two, say "submit button at the end 
of the form"?

Technique F36 - under description, maybe delete "and enter key" (find this 
somewhat confusing?)
For text for failure example 2, instead of "correct it", maybe "correct the 
error"?

Technique F37 - OK

meet" document is not entirely consistent with the success criteria.   The 
various techniques
do not seem to be consistent with the how to meet document.

-----------------------------------------------------------------------------------

3.2.3

  SC - does "occur" refer to structure or to presentation - also implies 
that there is only
one order (could there be multiple orders?)?

definition of "Web page" - do the examples pertain to the note or to the 
basic definition?
I don't think this is clear..  If the former, should be made clear how 
these examples fit the
definition..  For definition of "set of Web pages" - space between 
"eachother" - also what about
different versions (simpler, more complex) of the same content (would they 
be considered different
bodies of work)?  Also do we want to add for definition "exclusive 
relationship to each other"
  to separate those pages in the set from those outside the set..

definition of "same relative order" - do we want to add "on each Web page" 
in the set?  Also
what is the "original order"?  It's important to be as precise as possible 
if these definitions
are normative..

For "intent of this SC" section, what is the difference in this context 
between "presentation"
and "layout"?  What is a "page boundary"?  Maybe add "Web page.."?  For 
"the order", what order
are we talking about (presentation, structural, DOM?), and can there be 
more than one "order"?

For the "specific benefit" section, do we want to use "mechanisms" in place 
of "components" for
consistency?  Also maybe another word for "things"?  Add "web" to "site and 
"age"?

Replace "component" and "link" with "mechanism" throughout, and replace 
"navigation" with
"navigational" if appropriate to match the SC?

For the first bullet of "Examples", "users" should be "Users"  Also, does 
the user know via
previous instruction that the search field is the last on every Web page in 
the site?

For the second bullet of "Examples", add "Web" to "site"?

For the third bullet of "Examples", add "Web" to "page"?

For the fourth bullet of "Examples", add "Web" to "page"?

Technique G61 - Is this technique really applicable to all 
technologies?  Seems like an
expansive claim..  For the related techniques, where does the location 
information in parentheses
(consistent navigation) come from (does it match the title of the 
referenced technique?)?

In "description", replace "component" with "mechanism" throughout, and 
replace "navigation"
with "navigational" if appropriate?  "layout or presentation" -
which is it?  Also, "presentation" and "presenting" used later in sentence 
in different context?
Also replace "sometime" with "sometimes"?  For Tests procedure, replace 
"component" with "navigational
mechanism"?  Replace "appears" with "occurs"?  Add "the" in front of 
"other"?  Replace "the links"
by "all links"?

Technique F66 - Is this technique really applicable to all 
technologies?  Seems like an
expansive claim..  For "description", replace "navigation" with 
"navigational" (also in title)?
In title, add "Web" to "page"?  I would restate the last sentence as "a 
different order on two
or more Web pages within a set of Web pages, then.."

For Tests procedures, number one, add "al" to "navigation" and add at end 
"in a set of Web pages".
For number two, change "default presentation" to "occurrence"?  Also add 
"Web" to "page", and
add "in a set of Web pages" to end.

-----------------------------------------

3.2.4

  definition of "same functionality" - "result" from whose standpoint?  For 
"Example" following, delete
"submit" before "search", and replace "they" by "the buttons".  NOTE: This 
example is repeated again later in the
SC "how to meet" text - do we want to do this?  For definition of "Web 
page", access previous comments for this
definition in other SCs..

For the "intent" section, replace "use" by "employ" after "readers"?  Maybe 
replace "that appear repeatedly" with
"have the same functionality"?  Or at least replace "appear" with "occur" 
where ever possible?  Eliminate "the"
from "the text alternatives'?  Insert "similar" between "with" and "functions"?

For "specific benefits" section, first bullet, add "Web" before "page", and 
"Web" before "site"?  Add to end
  of sentence "and labelled consistently"..   For third bullet, add "more 
easily" between "also" and "search", and
add "Web" before "page"..

For "sufficient techniques", difference between "label" and "name"?  For 
the two techniques given (H44 and H65),
do both need to be satisfied for sufficiency?  Only one of them?  This 
needs to be explained..

For Note 2, remove "-" before "item"?  Maybe restate rest of Note 2 as 
"Examples can be commonly found with the
use of a single icon type, such as check marks, cross marks, and traffic 
signs, across a set of Web pages.
The functions of this icon can be different depending on the context of 
each Web page.  For example, a check mark
icon may function as either "approved", "completed", or
"included", depending on the situation.  Thus, using "check mark" as a text 
alternative across all Web pages does
not help user understand the different functions of the icon across these 
Web pages.  Different text alternatives
should be used when the same non-text content serves multiple functions 
across a set of Web pages."

For the "additional techniques (advisory)" section, I'm not sure the first 
bullet fully addresses this SC..

For "Example 1", maybe say "indicate that a document can be downloaded at 
certain locations throughout a Web site".
"Example 2" seems like a violation of SC to me.  In any case, maybe insert 
"must" between "they" and "have".
For "Example 3", add "Web" before "page", and say "page 2, page 3" instead 
of "page 2, page 2"?
Does "Example 4" deal with Web content (says "application")?  For "Example 
5", "throughout" instead of "through out",
Add "Web" before "site"?  Say "page save" functionality?  For "Example 6", 
this is repeated earlier under definition
of "same functionality"?  Delete "submit" before "search button"?  Add "in 
a set of Web pages" after "page"?  Add
at end of last sentence, "because different verbs are used"?

Technique H44 - OK, except that for "Tests procedures", "purpose of the 
control" seems to go beyond simple
association, which is the subject of this technique..

Technique F31 - does this really apply to "all technologies"?  Seems like 
an expansive claim?
For "Tests procedure", number 2, say "each such component" and replace 
"naming" with "labelling"?

Technique H65 - SC3.2.4 is not given in the list of related SCs; also we 
have "how to meet's" included in
the list along with the SCs; do we do this for other techniques?  From the 
description I'm not sure how this
technique relates to SC3.2.4 (which talks about consistency of 
identification, not about whether a label or
title can be used in the first place).  For "Examples", just say "A form", 
not "a search form"..
For "Tests procedures", I'm not sure that #3 ("purpose") is covered by the 
title of the technique.. identifying
the purpose of a control is more than identifying the control per se..

-------------------------------------------

3.2.5

  SC OK.. for definition of "changes of context, I'm still not sure of the 
precise difference between
  changes of content and changes of context, in an objectively testable or 
definable sense..  For example, what
is the precise definition of "meaning"?

"Intent" seems OK, but what about necessary changes of context initiated 
from outside sources for security reasons, for
example, or from servers for time outs?

For first bullet of "specific benefits", aren't individuals that "may not 
realize that the context has changed"
included in individuals who are "unable to detect changes of context"?  I'm 
not sure that we need the latter clause
  as stated in the current sentence as written?  Spelling - "example" 
instead of "examle"?  For sub bullet of
first bullet, don't we repeat the first two bullets of "benefit" in an 
earlier SC 3.2.2?  If so, do we want
  to have the exact same benefit
language for two different SCs?  See my comments on these bullets in SC3.2.2..
Is the third bullet true?  Is there hard evidence that such people "do not 
get confused"?  Do we want to say
"may not get confused"?  Also, I'm not sure that this bullet addresses 
SC3.2.5 (supports server changes of
context which are supposedly not allowed by SC 3.2.5-only user initiations 
are allowed)

The first sentence of "Techniques for Addressing SC3.2.5" ("each numbered 
item in this section") does not seem
to be consistent with the use of situations following..  Are the situations 
mutually exclusive for a particular
Web page (as is implied by the current language)?  Is "sufficient for a 
situation" the same as "sufficient for
a SC"?  Does the premise of Situation B and Technique SVR1 violate the 
spirit of SC that only user initiations
  of changes of context
are allowed?  Does the first technique under Situation C (target attribute) 
involve user initiation?  How exactly
does
Situation D relate to the SC?  How exactly do the advisory HTML techniques 
relate to the SC?

For "examples",  first one, say "update now button that enables a user to 
request a refresh of the content"?
How does the second example relate to the SC (involves automatic redirects, 
not user initiation)?

Technique G76 - does this technique apply to technologies that don't 
support automatic updates but do support
user-initiated updates also?  Should the description talk about disabling 
server-provided updates?  For test
procedures step 1, say "if such mechanisms are present"?  This procedure 
seems to imply that a mechanism can
either be update-able by the user, or automatically update-able, but not 
both -- is this what we want to say - can]
content be both but have automatic updates disabled?

Technique G110 - how does this technique relate specifically to SC (talks 
about redirect but SC talks about
user initiation)?  Also tests procedure step 1 remove "page or"?  Steps 2 
and 3 seem inconsistent and even
contradictory, and also testability concerns with "related" in step 3?

Technique F60 - what does "general" applicability mean in this context 
(technique mentions "window" and "input field")?
How does the "other than error reporting" fit in to the technique title?

Technique F61 - Should the description mention that there should be 
notification to the user in advance that the
content is scheduled to be automatically updated, and the user has an 
option before this automatic update
occurrence to disable it?  For the tests procedure, step 2, what is the 
reason for "24 hours"?  What does it
mean to "leave the content open"?  For step 3, add "after 24 
hours"?  Should step 4 come between step 1 and
step 2?  For the expected result, shouldn't step 4 be false instead of true 
for the failure to apply?

Technique SCR19 - I'm not sure how this technique relates to the SC (the SC 
talks about changes of context, and
this technique talks about not changing context?)?

Technique SVR1 - does this technique involve user initiation for changes of 
context  (seems to talk about
how to do automatic redirects)?  Also insert "Web" before "page' in 
description?  For tests procedure step 1,
  what does "page or Web page" mean (just use "Web page")?  Step 3 involves 
testing a negative?

Technique F22 - What does "general" mean in this context ("windows" is 
mentioned)?  Does the description cover
user initiation (talks about "expectations?)?  Maybe replace "a piece of 
User Interface" with "component"?  Add "Web"
before "page" in failure examples 1, 3, and 4?  For the expected results, 
second bullet, say "if step 2 is false,
but step 5 is true and step 6 is false, .."?

Technique F9 - is applicability really general (technique talks about form 
element)?







  
Received on Monday, 30 April 2007 12:53:48 GMT

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