[Bug 5423] 2.2 terminology

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





------- Comment #7 from johnarwe@us.ibm.com  2008-02-14 01:40 -------
I agree w/ Kirk, overall a vast improvement.  SML Ref Scheme is a bit mushy
though.  It feels like it is mixing the definition (what the scheme consists
of) with other statements that are true but not really part of that definition.

Proposal:

SML Reference
    A link from one element in an SML model to another element in the same
model.  An SML reference may be represented by instances of multiple, different
SML reference schemes. 

SML Reference Scheme
An SML Reference Scheme RS is a set of rules defining the syntax used to
represent an instance of RS in the context of an SML reference, plus a set of
rules for resolving an instance of RS to a set of target element nodes.  This
specification specifies how an SML reference scheme must be defined [4.3 SML
Reference Schemes] and also specifies one such SML reference scheme, the SML
URI Reference Scheme [4.3.1 SML URI Reference Scheme].  Whenever "reference
scheme" occurs in this specification, it should be assumed to mean "SML
reference scheme" unless otherwise noted.  Despite similar names, the term SML
reference scheme is unrelated to XPointer schemes and URI schemes.

Target
    An element in a model to which an SML reference resolves is called the
target of that SML reference.  Multiple SML references targeting the same
element may use multiple, different SML reference schemes. 

original text + (reasoning for each change above)
A representation of an SML reference. (this defines an instance of a ref
scheme, which is different than the ref scheme definition)
An SML reference may be represented by multiple, different SML reference
schemes. (true, but relevant to sml ref not sml ref scheme's def)
Also, multiple SML references targeting the same element may use multiple,
different SML reference schemes. (ditto, relevant for target not ref scheme
def)
This specification specifies how an SML reference scheme must be defined [4.3
SML Reference Schemes] and also specifies one such reference scheme, the SML
URI Reference Scheme [4.3.1 SML URI Reference Scheme]. (true, first part at
least relevant, second part...?)
Whenever "reference scheme" occurs in this specification, it should be assumed
to mean "SML reference scheme" unless otherwise noted. (relevant)
An SML reference scheme is unrelated to XPointer schemes. (relevant, perhaps
incomplete if the goal is to distinguish from other easily confused "schemes")

Received on Thursday, 14 February 2008 01:40:10 UTC