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 5113 - smlif minor editorial comments
Summary: smlif minor editorial comments
Status: RESOLVED FIXED
Alias: None
Product: SML
Classification: Unclassified
Component: Interchange Format (show other bugs)
Version: unspecified
Hardware: PC Windows XP
: P2 normal
Target Milestone: LC
Assignee: Valentina Popescu
QA Contact: SML Working Group discussion list
URL:
Whiteboard:
Keywords: resolved
Depends on: 5101
Blocks:
  Show dependency treegraph
 
Reported: 2007-10-01 14:25 UTC by John Arwe
Modified: 2007-11-22 17:44 UTC (History)
0 users

See Also:


Attachments

Description John Arwe 2007-10-01 14:25:21 UTC
SMLIF 2 Informal Desc 
from "...permits many different addressing mechanisms."
to   "...permits many different reference schemes    ."

SMLIF 2 Informal Desc 
from "...to establish which element the reference points to."
to   "...to establish which         the reference target   ."
(term defined via bug 5101)

3.1 Conformance Criteria, 3.2 Terminology
Render consistently w/ SML.  Suggest adopting SML's structure and placement for each, adding "Notations & Terminology" heading ala SML.

3.1 Conformance Criteria
Re-cast statements using RFC2119 keywords.

3.3 SML-IF Documents
[Definition: ...]
move all of these in a named section like SML
render all of them consistently across both specs (either all [Definition: ...]
or none that way)

3.3 SML-IF Documents
fix all [Ed. note: insert link to definition]

3.3 SML-IF Documents
from "interchange set MUST appear as a child of a document element that is a child of the definitions element of the SML-IF document"
to   "interchange set MUST appear as a child of a model/definitions/document element"

3.3 SML-IF Documents
from "interchange set MUST appear as a child of a document element that is a child of the instances element of the SML-IF document"
to   "interchange set MUST appear as a child of a model/instances/document element"

3.3.1 Embedded Documents
from "If a       document is to be embedded..."
to   "If a model document is to be embedded..."

3.3.1 Embedded Documents - Note
add "non-normative"

3.3.1 Embedded Documents
from "...the content of the data child of the corresponding document element."
to   "...the content of */document/data."

3.4.2 Definition of inter-document references in SML-IF
change to monospace font
- "xs:" (2x)
- "list of" between type and xs:anyURI

3.4.2 Definition of inter-document references in SML-IF
from "...is defined by     protocol binding used to interact with the endpoint"
to   "...is defined by the protocol binding used to interact with the endpoint"

3.4.3 SML reference schemes that are not SML-IF inter-document references
from "3.4.3 SML reference schemes that are not SML-IF inter-document references"
to   "3.4.3 Not all SML reference schemes are SML-IF inter-document references"

3.4.3 SML reference schemes that are not SML-IF inter-document references
italicize both words in "reference schemes", first line

3.4.4 Document aliases
from "...there can be no inter-document references to it."
to   "...there can be no inter-document references or rule bindings to it."

3.5.1 URI prefix matching
fix [Ed. note: add link to definition] 

3.5.1 URI prefix matching
from "...combination of     alias mechanism described above..."
to   "...combination of the alias mechanism described above..."

3.5.1 URI prefix matching
"combination of alias mechanism described above and URI prefix matching."
insert reference to 3.4.4, now several sections away

3.5.2 Bindings defined
from "...various uses of SML-IF may well choose..."
to   "...various uses of SML-IF MAY      choose..."

4.1 Normative References
from "Service Modeling Language, Version 1.1, John John, Editors...."
to   "Service Modeling Language, Version 1.1, -correct editors-, Editors...."

B. Open Issues (Non-Normative)
remove entire section
we opened bugs for all of these in June
Comment 1 Virginia Smith 2007-10-26 15:44:17 UTC
All changes made except for changes to secion marked section 3.4.3 - since this overlaps with bug 4865. (this section is 4.3.3 in latest version)

Also changed inter-document to interdocument based on research into technical style guides.
Comment 2 Sandy Gao 2007-11-22 16:16:58 UTC
Reopening this bug. The following comment:

3.3.1 Embedded Documents - Note
add "non-normative"

Should only be applied to the "Note"; but the entire section (now 5.2.1) was marked non-normative.
Comment 3 Valentina Popescu 2007-11-22 17:44:54 UTC
Fixed per comment #2; moved non-normative comment under the Note

http://dev.w3.org/cvsweb/~checkout~/2007/xml/sml/build/sml-if.html?content-type=text/html;%20charset=utf-8#embedded_documents