[office] ODF 1.2 Version Significance Proposal - Update #1

["Dennis E. Hamilton" <dennis.hamilton@acm.org>]

Michael, I want to respond to your remarks in in individual parts.  I will incorporate the rationale and the restatements in the proposal at <http://wiki.oasis-open.org/office/ODF_1.2_Version_Significance>.  I will produce a recap that combines all of these updates as the revised draft.

STATEMENT OF REQUIREMENT FOR THE FIVE office:version ATTRIBUTE ELEMENT OCCURRENCES

[January 5 proposed text (in wikiText format)[
=== 18.588 The office:version attribute ===
 
The office:version attribute is required for each and every <office:document>, <office:content>, <office:document-styles>, <office:document-meta>, and <office:document-settings> element in the XML documents that comprise an ODF 1.2 document.  
]]

COMMENT:

This is information that we have already in the schema and the element
list  we generate from it. I'm wondering if we really have to repeat
this information in prose.

RESPONSE:

I suggest leaving this statement in, along with the initial sentence that I am adding (below), until it is clear what is normative and how readily someone who has the specification in their possession can also consult the normative schema.  This statement can be reviewed for accuracy and necessity as part of a final pass before going to Committee Draft public review.

At present, the element list does not indicate when an attribute shall occur, only that it can occur.

Appendix A of OpenDocument-v1.2-draft7-13 only refers to "OpenDocument-schema-v1.2-draft7.rng" by relative URL.  I'm not aware of anything in the current document that identifies that schema (with updated name) as normative and that specifies how that schema is to be found.

RESTATEMENT:

[January 9 proposed text:[
=== 18.588 The office:version attribute ===

The office:version attribute identifies the version of ODF specification that defines the associated element, its schema, its complete content, and its interpretation.

The office:version attribute shall be present in each and every <office:document>, <office:contet>, <office:document-styles>, <office:document-meta>, and <office:document-settings> element in the XML documents that comprise an ODF 1.2 document.  The value of the office:version attribute shall be "1.2".
]]


NOTE: I am assuming that the JTC1 normative language is to be used.  I didn't catch that in the earlier version.


-----Original Message-----
From: Michael.Brauer@Sun.COM [mailto:Michael.Brauer@Sun.COM] 
http://lists.oasis-open.org/archives/office/200901/msg00041.html
Sent: Tuesday, January 06, 2009 05:24
To: dennis.hamilton@acm.org
Cc: 'ODF TC List'; Rob Weir
Subject: Re: [office] ODF 1.2 Version Significance Proposal

Hi Dennis,

thank you very much for the proposal. Please find a couple of
comments/suggestions below:

On 05.01.09 01:24, Dennis E. Hamilton wrote:
http://lists.oasis-open.org/archives/office/200901/msg00011.html
> I have been careless in having a reviewable version of my proposal on ODF 1.2 Version Significance available in advance of the January 5 coordination call.  I also broke my promise to have this proposal "in a complete form, and under discussion on the list, by January 1, 2009."
> 
> PROPOSED CONTINUATION ON THE PROPOSAL
> 
> The proposal has been updated with complete text for the description of "office:version":
> http://wiki.oasis-open.org/office/ODF_1.2_Version_Significance
> The proposed text is also included below (in wikiText).
>   
> I recommend that this proposal be discussed on the list between now and the January 12 call.  Discussion on January 5 is welcome, but I accept that most participants will have not had an opportunity to give the proposal much consideration at that time.
> 
> I do not propose to deal with "manifest:version" here.  We can look at that, if necessary, as part of reviewing Part 3 of the ODF 1.2 specification.  
> 
> PROPOSED TEXT
> 
> == Requested changes to the ODF Standard ==
> 
> {{{ This version of the proposal does not address the manifest:version attribute.  This should be dealt with separately. }}}
> 
> Replace the text in section 18.588 of OpenDocument-v1.2-draft7-13.odt with the following text:
> 
> === 18.588 The office:version attribute ===
> 
> The office:version attribute is required for each and every <office:document>, <office:content>, <office:document-styles>, <office:document-meta>, and <office:document-settings> element in the XML documents that comprise an ODF 1.2 document.  

This is information that we have already in the schema and the element
list  we generate from it. I'm wondering if we really have to repeat
this information in prose.

[ ... ]