[Bug 5398] SMLIF 5.2 clarifications


           Summary: SMLIF 5.2 clarifications
           Product: SML
           Version: unspecified
          Platform: PC
        OS/Version: Windows XP
            Status: NEW
          Severity: normal
          Priority: P2
         Component: Interchange Format
        AssignedTo: cmsmcq@w3.org
        ReportedBy: johnarwe@us.ibm.com
         QAContact: public-sml@w3.org

5.2 SML-IF Documents
"An SML-IF document MUST conform to XML [XML] specification." is awkward.  We
might be better off using something like the SML definition for document in its
place, i.e. "An SML-IF document MUST be a well-formed XML document, as defined
in [XML]."

5.2.1 Embedded Documents - last sentence
currently says "If model/*/document/data contains no child element or
model/*/document/base64Data has empty content then the SML-IF consumer MUST
treat the document as if it is not part of the interchange set."
Different phrases ("no child element", "empty content" respectively) are used
for data and base64data to describe what I expected to be the same condition. 
If they are the same condition, it would be clearer to use identical words to
describe it.  If they are different descriptions, this text does not tell me as
a reader what those differences are in a precise way that I understand.

Received on Tuesday, 22 January 2008 12:51:10 UTC