[Bug 5720] Inconsistent languge describing sml references and schemes

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





------- Comment #3 from virginia.smith@hp.com  2008-05-29 15:09 -------
Proposal:

1- Expand section 4.1.1 (definition of an SML reference) to include some text
about reference schemes as follows:

“An SML reference is considered to be an instance of a specific SML reference
scheme, if it can be identified as such according to the SML reference scheme
rules. See [link to 4.3]. An SML reference MAY be an instance of multiple SML
reference schemes.

2 - In section 4.1.3, change bullet 2 ("None of the recognized reference
schemes resolves to an element in the model.") to "None of the reference
schemes, of which the SML reference is recognized as an instance, resolves to
an element in the model."

3 - In section 4.2.2, change "If a non-null SML reference contains multiple
reference schemes" to "If a non-null SML reference is an instance of multiple
reference schemes". Make similar change to all uses of "contains".

4 - Change the 1st 2 paragraphs in section 4.3 to the following (changes in
**):
“An SML reference MAY be *an instance of* a variety of reference schemes. SML
does not mandate the use of any specific reference schemes. An SML reference
scheme MAY use child elements, attributes, both, or neither to capture the
information necessary to identify the reference target. It is not required that
all elements in an SML model be reachable via an SML reference. This will
depend on the support defined by the chosen reference scheme.

Although SML does not require the use of any specific scheme, it does specify
how a reference MUST be represented when using SML-defined reference schemes.
This specification defines the 4.3.1 SML URI Reference Scheme for *use* in SML
references.”

5 - Section 9.2.4 (non-normative) - Change "Specifies an SML reference
represented by the SML URI reference scheme." to "Specifies an SML reference
that is an instance of the SML URI reference scheme."

6 - In the definition of SML Reference Scheme: Change "An SML Reference Scheme
is a set of rules defining the syntax used to represent an instance of the
reference scheme" to "An SML Reference Scheme is a set of rules defining the
syntax used to identify an instance of the reference scheme"

7 - Review doc to see if there are other locations that should be changed
similar to the above changes.

Received on Thursday, 29 May 2008 15:12:21 UTC