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 5283 - "interchange set" or "interchange model"
Summary: "interchange set" or "interchange model"
Status: RESOLVED FIXED
Alias: None
Product: SML
Classification: Unclassified
Component: Interchange Format (show other bugs)
Version: FPWD
Hardware: PC Windows XP
: P2 normal
Target Milestone: CR
Assignee: Virginia Smith
QA Contact: SML Working Group discussion list
URL:
Whiteboard:
Keywords: editorial
Depends on:
Blocks:
 
Reported: 2007-11-25 20:27 UTC by Sandy Gao
Modified: 2008-12-09 17:59 UTC (History)
1 user (show)

See Also:


Attachments

Description Sandy Gao 2007-11-25 20:27:18 UTC
In IF, "interchange set" is defined as:

"The SML-IF interchange set is the set of documents that constitute the SML model to be interchanged."

In SML, "model" is defined as:

"A set of inter-related documents that describe a service or system."

So they both are "a set of documents", and are obviously the same set in the IF context. That is, "The SML-IF interchange set" and "the SML model to be interchanged" are the same. bvgMaybe we should have called it "interchange model" to make this clear?
Comment 1 Sandy Gao 2007-11-28 23:17:47 UTC
This can be viewed as a purely terminological issue and doesn't have to be resolved before LC.
Comment 2 Pratul Dublish 2007-11-29 19:17:19 UTC
Will discuss this post LC
Comment 3 Virginia Smith 2008-02-08 00:15:26 UTC
Also, see new terminology that has been introduced in the IF spec (Terminology section). 
Comment 4 Kumar Pandit 2008-03-13 18:44:32 UTC
resolution (3/13 conf call): mark needsAgreement
Kumar, Sandy, Ginny & Kirk to discuss a proposal.
Comment 5 Pratul Dublish 2008-03-31 21:05:19 UTC
As per the resolution in F2F on 3/31, we'll use the term "interchange model"
Comment 7 John Arwe 2008-04-10 13:01:46 UTC
1. I feel a "tautological" statement coming on (I must be channeling Kirk now):

Interchange Model - An interchange model is an SML model [SML 1.1] being interchanged.

2. I'd prefer the older "constitutes" to "contains".  The latter implies "embedded" to me, whereas the former does not.

SML-IF Document - An SML-IF document is an XML document that contains the set of documents that represent an interchange model. See [5.1 Conformance Criteria].

3. There is content, both semantic and syntactic, in an SML-IF document that is not asserted by SML to be part of an SML model by the definition in SML.... aliases and model identity, as some examples.  Thus it seems to me that a more accurate depiction would be something like:

- An interchange model is an SML model (i.e. a set of related XML documents), augmented with data about the model useful for interchange, e.g. model identification information, and metadata about the model's documents, e.g. document aliases.

- An SML-IF document is a syntactic representation of an interchange model.  It includes the model's identity, its documents (by value or by reference), metadata about its documents, and a syntactic representation of concepts defined as part of an SML model but lacking an SML-defined sytnax (e.g. rule bindings).
Comment 8 Kumar Pandit 2008-04-16 23:12:41 UTC
I agree with bullet #2 and #3 in comment# 7 by John (I am neutral about bullet #1). 

+1 for rest of the changes.
Comment 9 Kumar Pandit 2008-04-17 19:20:49 UTC
re: comment# 7 bullet# 2: The WG agreed to use 'specifies' instead of either 'constitutes' or 'contains'.
Comment 10 Virginia Smith 2008-04-17 20:28:25 UTC
Fixed per comment #9.

We still have to decide on comment #7, bullet 3.
Comment 11 Kumar Pandit 2008-05-01 19:51:03 UTC
resolution in conf call (5/1/08):
interchange model as in comment 7 #3 (dashed bullet 1)
smlif doc: - An SML-IF document is a XML representation of an interchange model.  It includes the model's identity, its documents (by value or by reference), metadata about its documents, and a syntactic representation of concepts defined as part of an SML model but lacking an SML-defined sytnax (e.g. rule bindings).

mark editorial
Comment 12 Virginia Smith 2008-05-15 16:29:11 UTC
Fixed per comment #11.

Definition of SML-IF Document changed from:
-------
An SML-IF document is an XML document that specifies the set of documents that represent an interchange model. See [5.1 Conformance Criteria].
------

To
------
An SML-IF document is an XML representation of an interchange model. It includes the model's identity, its documents (by value or by reference), metadata about its documents, and a syntactic representation of concepts defined as part of an SML model but lacking an SML-defined sytnax (e.g. rule bindings).
------
Comment 13 John Arwe 2008-08-15 12:21:13 UTC
The current editors' draft still has 3 occurrences of the term "interchange set":
2.2 SML-IF Consumer
4.3 Rule Bindings
B. Localization of IF Identity Sample

I am preemptively marking this editorial since (a) there is no conceptual change proposed, it is merely finishing the implementation of a previous decision (b) it might be possible, although "clearly" it is not required, to fix this before the next LC draft is published, given its petite size.
Comment 14 Virginia Smith 2008-08-15 18:25:49 UTC
Fixed per comment #13.