<?xml version="1.0" encoding="UTF-8" standalone="yes" ?>
<!DOCTYPE bugzilla SYSTEM "https://www.w3.org/Bugs/Public/page.cgi?id=bugzilla.dtd">

<bugzilla version="5.0.4"
          urlbase="https://www.w3.org/Bugs/Public/"
          
          maintainer="sysbot+bugzilla@w3.org"
>

    <bug>
          <bug_id>5437</bug_id>
          
          <creation_ts>2008-01-29 03:27:27 +0000</creation_ts>
          <short_desc>5.1.1 Using the SML-IF Version Attribute</short_desc>
          <delta_ts>2008-02-14 20:30:13 +0000</delta_ts>
          <reporter_accessible>1</reporter_accessible>
          <cclist_accessible>1</cclist_accessible>
          <classification_id>1</classification_id>
          <classification>Unclassified</classification>
          <product>SML</product>
          <component>Interchange Format</component>
          <version>LC</version>
          <rep_platform>PC</rep_platform>
          <op_sys>Windows XP</op_sys>
          <bug_status>RESOLVED</bug_status>
          <resolution>FIXED</resolution>
          
          
          <bug_file_loc></bug_file_loc>
          <status_whiteboard></status_whiteboard>
          <keywords>resolved</keywords>
          <priority>P2</priority>
          <bug_severity>normal</bug_severity>
          <target_milestone>LC</target_milestone>
          
          
          <everconfirmed>1</everconfirmed>
          <reporter name="Valentina Popescu">popescu</reporter>
          <assigned_to name="Valentina Popescu">popescu</assigned_to>
          
          
          <qa_contact name="SML Working Group discussion list">public-sml</qa_contact>

      

      

      

          <comment_sort_order>oldest_to_newest</comment_sort_order>  
          <long_desc isprivate="0" >
    <commentid>18620</commentid>
    <comment_count>0</comment_count>
    <who name="Valentina Popescu">popescu</who>
    <bug_when>2008-01-29 03:27:27 +0000</bug_when>
    <thetext>There are a few issues with the current content

1. This sentence doesn&apos;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 &gt;&gt;&gt;enountered&lt;&lt;&lt; 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:

&quot;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.
&quot;

5. Propose updating the section title from 

Using the SML-IF Version Attribute
to
SML-IF Document Version</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>18622</commentid>
    <comment_count>1</comment_count>
    <who name="Valentina Popescu">popescu</who>
    <bug_when>2008-01-29 03:41:39 +0000</bug_when>
    <thetext>One more to add :

Move this section under 5.2.x where the rest of the document-level stuff lives. It is currently defined under the conformance section.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>18672</commentid>
    <comment_count>2</comment_count>
    <who name="Valentina Popescu">popescu</who>
    <bug_when>2008-01-31 20:59:17 +0000</bug_when>
    <thetext>reviewed in 01/31 meeting; resolution to mark editorial 

require needsReview on completion </thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>18687</commentid>
    <comment_count>3</comment_count>
    <who name="Valentina Popescu">popescu</who>
    <bug_when>2008-02-02 00:16:08 +0000</bug_when>
    <thetext>Changes :

1. Section &apos;Using the SML-IF Version Attribute&apos; renamed to &apos;SML-IF Document Version&apos; and moved under the section 5.2 SML-IF Documents.
Updated content :

5.2.4 SML-IF Document Version

An SML-IF producer MAY specify the version of the SML-IF specification with which conformance is declared by including the version number of the relevant specification as the value of the SMLIFVersion attribute in the document&apos;s model element. This value MUST be 1.1 for documents conforming with the current specification. SML-IF Consumers MUST attempt to process an SML-IF document regardless of the value of the SMLIFVersion attribute. Therefore, an SML-IF Consumer MUST NOT reject the document simply on the basis that it has a different version of the specification.

Note:

This note is non-normative: Requiring consumers to continue processing in the face of unknown version values makes it easier to deploy documents that support future versions of this specification. 

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


2. New non-normative content created under 4.1 Packaging :

The SMLIFVersion attribute is defined on the model element and may be useful when diagnosing failures encountered while processing SML-IF documents. For example, if a document asserts conformance with version 1.1 of the SML-IF specification 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.

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



</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>18998</commentid>
    <comment_count>4</comment_count>
    <who name="Kumar Pandit">kumarp</who>
    <bug_when>2008-02-13 08:04:59 +0000</bug_when>
    <thetext>+1 for the changes.</thetext>
  </long_desc><long_desc isprivate="0" >
    <commentid>19034</commentid>
    <comment_count>5</comment_count>
    <who name="John Arwe">johnarwe</who>
    <bug_when>2008-02-14 02:07:25 +0000</bug_when>
    <thetext>+1 too</thetext>
  </long_desc>
      
      

    </bug>

</bugzilla>