[Bug 5423] 2.2 terminology

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

           Summary: 2.2 terminology
           Product: SML
           Version: LC
          Platform: PC
        OS/Version: Windows XP
            Status: NEW
          Severity: normal
          Priority: P2
         Component: Core+Interchange Format
        AssignedTo: cmsmcq@w3.org
        ReportedBy: johnarwe@us.ibm.com
         QAContact: public-sml@w3.org


(1) Both: it would help readers if we document the "strategy" used to arrange
the set of terms, e.g. as text between the heading and the def list.  I think
the current strategy is to "build up", so each definition can re-use terms
already defined, but we do not do so in all cases so it is difficult to be
sure.

(2) SML: "Reference" probably should be "SML Reference".  May be covered by
5388.

(3) SML: The def for "model def docs" ends with "...in SML model validation." 
Later the term "model validation" is defined, but not "SML model validation". 
Rigorous consistency is most likely to help readers.

(4) SML: The def of target complete URI refers to two terms not currently
defined, "target" and "SML reference".  The former probably needs to be added. 
The latter should be defined, and may already be covered by 5388.

(5) SMLIF: SMLIF introduces some concepts not currently defined in 2.2 in
either spec, that we should probably add, e.g. alias, schema document binding.

(6) Both: SMLIF section 5.4 is titled "Rule Document Bindings", a term I see in
neither spec's 2.2 content.  Needs to be reconciled against the other
rule/binding terms floating around.

Received on Friday, 25 January 2008 20:42:27 UTC