[Bug 5395] Normative discussion of schemaComplete

http://www.w3.org/Bugs/Public/show_bug.cgi?id=5395





------- Comment #9 from virginia.smith@hp.com  2008-01-29 21:50 -------
I suggest the following changes:

In section 2.2, change definition to:

Interchange set validation is the process of assessing the validity of the SML
model [SML 1.1] represented by the interchange set while maintaining all
assertions and interrelationships among the documents in the interchange set as
defined by this specification.

In section 4, change last paragraph to: 

Getting consistent model validation results: The process of SML model
validation defined in [SML 1.1] contains points of variability that, left
unconstrained, would make it difficult for SML-IF to ensure interoperability of
independent implementations in any practical way.  Many of these sources of
variability are inherited from other specifications that SML uses, e.g. URI
comparison [RFC 3986] and the source of Schema components [XML Schema 1.0] used
to validate model instance documents.  SML-IF constrains these points of
variability with the goal of ensuring interoperability when specific conditions
are met and increasing the likelihood of interoperability in other cases. 

In section 4.1, change inserted paragraph to:

The schemaComplete attribute is defined on the definitions element and is used
to indicate that the schemas constructed from the definition documents in the
interchange set are complete, in the sense that the validity of the SML model
represented by the interchange set is fully determined by these schemas.
Formally, however, the schemaComplete attribute does not express any assertion
that the schemas so constructed are, in fact, complete, or that validation
using these schemas will not result in any errors. The only formal effect of
schemaComplete attribute with a value of true or 1 is to specify precisely the
schemas with which interchange set validation is to be performed.

In section 5.1, remove sentence "A conforming SML-IF Validator..." I don't
think this is necessary and should be covered by the conforming consumer
criteria (and the SML spec).

In section 5.1, move sentence "In particular..." to the end of the previous
paragraph.

In section 5.2, change 4th paragraph to one sentence (note that 'definition'
and 'instance' are now singular):
The definition and instance documents packaged by an SML-IF document MAY form a
valid SML model but it is not required to do so. 

In section 5.2.3, replace section text with the following and *also insert link
to the definition of interchange set validation:

The smlif:schemaComplete attribute is defined on the definitions element. The
attribute indicates whether or not all the definition documents required for
interchange set validation are included in the interchange set. If
schemaComplete has the value true or 1, then schemas used for interchange set
validation MUST contain only schema components declared in definition documents
(and built-in components) within the interchange set. If schemaComplete has the
value false or 0, then this specification does not constrain whether or not
definition documents required for interchange set validation are retrieved from
outside the interchange set.

Received on Tuesday, 29 January 2008 21:51:05 UTC