[Bug 5437] 5.1.1 Using the SML-IF Version Attribute

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

           Summary: 5.1.1 Using the SML-IF Version Attribute
           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: popescu@ca.ibm.com
         QAContact: public-sml@w3.org


There are a few issues with the current content

1. This sentence doesn't read well..

Therefore, a consumer of SML-IF document MUST NOT reject the document simply on
the basis that it has a different version of the specification.

propose to change it to :
Therefore, an SML-IF Consumer MUST NOT reject the document simply on the basis
that it has a different version of the specification.  

2. There is a typo on the Note section :

Non-normative note: The SMLIFVersion number may be useful when diagnosing
failures >>>enountered<<< while processing SML-IF documents.   

3. To follow the document format, the note should read:

Note 
This note is non-normative.The SMLIFVersion number may be useful when
diagnosing failures encountered while processing SML-IF documents. 


4. I think it would be better if the Note is actually moved under the
non-normative section ( 4. Informal Description ), with an updated content:

"The SMLIFVersion number may be useful when diagnosing failures encountered
while processing SML-IF documents.   E.g. if a document asserts conformance
with SML-IF 1.1 and a human can see that it is not in fact conformant, then it
is likely that the problem occurred during the production of the document. If
the same document appears to humans to be conformant, then the focus of
diagnosis might shift toward the consumer and its invocation parameters.

Requiring consumers to continue processing in the face of unknown version
values makes it easier to deploy producers and documents that support future
versions of SML-IF.
"

5. Propose updating the section title from 

Using the SML-IF Version Attribute
to
SML-IF Document Version

Received on Tuesday, 29 January 2008 03:27:35 UTC