[Bug 5113] smlif minor editorial comments

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

           Summary: smlif minor editorial comments
           Product: SML
           Version: unspecified
          Platform: PC
        OS/Version: Windows XP
            Status: NEW
          Keywords: editorial
          Severity: normal
          Priority: P2
         Component: Interchange Format
        AssignedTo: cmsmcq@w3.org
        ReportedBy: johnarwe@us.ibm.com
         QAContact: public-sml@w3.org
 BugsThisDependsOn: 5101


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

Received on Monday, 1 October 2007 14:25:32 UTC