- From: Tim Boland <frederick.boland@nist.gov>
- Date: Mon, 30 Apr 2007 08:52:38 -0400
- 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 UTC