This is an archived snapshot of W3C's public bugzilla bug tracker, decommissioned in April 2019. Please see the home page for more details.

Bug 6655 - Comment 2 (of 4) from WAI-PF
Summary: Comment 2 (of 4) from WAI-PF
Status: RESOLVED FIXED
Alias: None
Product: XML Schema
Classification: Unclassified
Component: Structures: XSD Part 1 (show other bugs)
Version: 1.1 only
Hardware: Macintosh Mac System 9.x
: P2 normal
Target Milestone: ---
Assignee: David Ezell
QA Contact: XML Schema comments list
URL: http://lists.w3.org/Archives/Public/w...
Whiteboard:
Keywords: resolved
Depends on:
Blocks:
 
Reported: 2009-03-05 22:18 UTC by C. M. Sperberg-McQueen
Modified: 2009-04-18 13:41 UTC (History)
2 users (show)

See Also:


Attachments

Description C. M. Sperberg-McQueen 2009-03-05 22:18:57 UTC
In email sent 26 Feb 2009 to the www-xml-schema-comments list on behalf
of the WAI PF working group

  http://lists.w3.org/Archives/Public/www-xml-schema-comments/2009JanMar/0150.html

Janina Sajka writes:

Re: Part 1, http://www.w3.org/TR/2009/WD-xmlschema11-1-20090130/

(1) Schema processors are now explicitly recommended to provide a user
option to control whether the processor attempts to dereference schema
locations indicated in schemaLocation attributes in the instance
document
being validated.  See
http://www.w3.org/TR/2009/WD-xmlschema11-1-20090130/#schema-loc.

We are concerned whether the average user can be expected to make a
reasonable decision whether the user agent should deference a schema
location?  After all, this decision may result in an invalidation of the
current document. We are particularly concerned that this is an even
greater burden for the user with a disability.

Considerations on how to represent this question to the user are covered
by UAAG, http://www.w3.org/wai/ua.

PF thanks Joseph Scheuhammer <clown@utoronto.ca> and Gottfried
Zimmermann <zimmermann@accesstechnologiesgroup.com> for reading the XSD
1.1 Last Call document on behalf of WAI-PF.
Comment 1 C. M. Sperberg-McQueen 2009-03-09 21:38:36 UTC
I wonder (speaking only for myself here, the WG has not yet had a
chance to discuss this issue) whether the situation would be improved
by adding a note to the spec, making clearer why the user option is
recommended and describing at least generally the situations in which
one might prefer to instruct the processor to follow, or to refrain
from following, schemaLocation hints.

Concrete proposal: in
http://www.w3.org/TR/2009/WD-xmlschema11-1-20090130/#schema-loc
the second paragraph of item 3 reads:

    Processors may attempt to dereference each schema document
    location URI in the ·actual value· of such xsi:schemaLocation and
    xsi:noNamespaceSchemaLocation [attributes]. Schema processors
    should provide an option to control whether they do so. It is not
    an error for such an attempt to fail, but failure may cause less
    than complete ·assessment· outcomes.

1) After this paragraph, insert the following note:

    NOTE: When systems rely on an input document being
    schema-valid with respect to a particular agreed-upon schema,
    it is important that they be able to have complete control
    over the choice of schema used in assessment and in
    particular that they be able to instruct the processor NOT to
    follow any schemaLocation hints in the input.  Otherwise, the
    input document could circumvent the agreement and the
    consumer's validation of the input, by referring to an
    alternative schema for the same namespaces, which declares
    the input document schema-valid but which does not adhere to
    the prior agreement between the data source and the data
    consumer.

    In other cases the purpose of assessment may be not to enforce a
    prior agreement between data source and consumer, but to annotate
    the input with type definitions and other useful information from
    the PSVI.  In such cases it will often be better to follow the
    schemaLocation hints.

    Users who need to exert control over the choice of schema can
    normally be expected to be aware of the requirement; conversely,
    users unaware of the issue will typically be those who are not
    relying on the use of a particular schema to enforce a specific
    agreement with the data source.  Casual users will often benefit
    from a default behavior of following schemaLocation hints.

    Useful guidance on how to present this and other questions to
    end users may be found in the W3C's User Agent Accessibility
    Guidelines [UAAG 1.0], [UAAG 2.0].

2) Add appropriate references for [UAAG 1.0] and [UAAG 2.0] to the
non-normative references.

If anyone in the WAI PF working group were willing to venture an
opinion on whether such a note would address the concern felt by WAI
on this topic, or use it to explain what else should be done instead
(or in addition), it would be helpful.

But (again speaking for myself) I have come to think that such a note
would be helpful to readers in any case, so I propose we make this
change regardless.

Comment 2 David Ezell 2009-04-10 17:05:10 UTC
At the 2009-04-10 telcon, the WG ammended the proposal in the previous comment.  The complete proposal as approved follows.  The WG has instructed the editors to go ahead and include the following proposal in the draft since it seems to be a substantive improvement.

The WG wishes to thank WAI PF for it's comments, with a request to let us know as soon as you can that you approve of our resolution.

Concrete proposal: 
in http://www.w3.org/TR/2009/WD-xmlschema11-1-20090130/#schema-loc
the second paragraph of item 3 reads:

    Processors may attempt to dereference each schema document
    location URI in the ·actual value· of such xsi:schemaLocation and
    xsi:noNamespaceSchemaLocation [attributes]. Schema processors
    should provide an option to control whether they do so. It is not
    an error for such an attempt to fail, but failure may cause less
    than complete ·assessment· outcomes.

1) After this paragraph, insert the following note:

    NOTE: Whether schema location information in the document instance 
    should or should not be dereferenced may vary with the purpose in view.

    When systems rely on an input document being
    schema-valid with respect to a particular agreed-upon schema,
    it is important that they be able to have complete control
    over the choice of schema used in assessment and in
    particular that they be able to instruct the processor NOT to
    follow any schemaLocation hints in the input.  Otherwise, the
    input document could circumvent the agreement and the
    consumer's validation of the input, by referring to an
    alternative schema for the same namespaces, which declares
    the input document schema-valid but which does not adhere to
    the prior agreement between the data source and the data
    consumer.

    In other cases the purpose of assessment may be not to enforce a
    prior agreement between data source and consumer, but to annotate
    the input with type definitions and other useful information from
    the PSVI.  In such cases it will often be better to follow the
    schemaLocation hints.

    Users who need to exert control over the choice of schema can
    normally be expected to be aware of the requirement; conversely,
    users unaware of the issue will typically be those who are not
    relying on the use of a particular schema to enforce a specific
    agreement with the data source.  Casual users will often benefit
    from a default behavior of following schemaLocation hints.

    Useful guidance on how to present this and other questions to
    end users may be found in the W3C's User Agent Accessibility
    Guidelines [UAAG 1.0], [UAAG 2.0].

2) Add appropriate references for [UAAG 1.0] and [UAAG 2.0] to the
non-normative references.
Comment 3 Noah Mendelsohn 2009-04-10 17:15:56 UTC
FWIW: as a working group member who has in the past had concerns about issues like this, I am completely happy with the proposed resolution.  Thank you.
Comment 4 C. M. Sperberg-McQueen 2009-04-18 13:41:01 UTC
The change described in comment 2 has been integrated into the status-quo
documents and the WAI PF working group has been informed of the disposition
of this and their other comments in email archived at

  http://www.w3.org/mid/F6DBA530-0B5D-4FF2-9CC4-2C02002694A1@blackmesatech.com

and asked to let us know whether they are content with the disposition or not.

Accordingly, I'm marking this issue RESOLVED / FIXED.