OASIS Open Document Format for Office Applications (OpenDocument) TC

I formally request consideration of the proposal "ODF 1.2 Version Significance" for ODF 1.2.

The new-proposal document with an incomplete sketch is on the wiki at
http://wiki.oasis-open.org/office/ODF_1.2_Version_Significance

The Brief description of the proposal is:

Provide a tightened definition of version-number significance in ODF documents that is backward compatible, precise, and anticipates  further versions.

 - Dennis

Dennis E. Hamilton
------------------
NuovoDoc: Design for Document System Interoperability 
mailto:Dennis.Hamilton@acm.org | gsm:+1-206.779.9430 
http://NuovoDoc.com http://ODMA.info/dev/ http://nfoWorks.org 

My promise is to have this proposal in a complete form, and under discussion on the list, by January 1, 2009.



                                                

					
                                                    

        
                                                
				
                                                

                                                    
                                                        
                                                        Original Message
                                                
                                                Original Message-----
From: Dennis E. Hamilton [mailto:dennis.hamilton@acm.org] 
http://lists.oasis-open.org/archives/office/200812/msg00076.html
Sent: Tuesday, December 09, 2008 22:44
To: ODF TC List
Subject: [office] Formal Request: ODF 1.2 Version Significance Proposal

I formally request consideration of the proposal "ODF 1.2 Version Significance" for ODF 1.2.

The new-proposal document with an incomplete sketch is on the wiki at
http://wiki.oasis-open.org/office/ODF_1.2_Version_Significance

The Brief description of the proposal is:

Provide a tightened definition of version-number significance in ODF documents that is backward compatible, precise, and anticipates  further versions.

 - Dennis

Dennis E. Hamilton
------------------
NuovoDoc: Design for Document System Interoperability 
mailto:Dennis.Hamilton@acm.org | gsm:+1-206.779.9430 
http://NuovoDoc.com http://ODMA.info/dev/ http://nfoWorks.org 


---------------------------------------------------------------------
To unsubscribe from this mail list, you must leave the OASIS TC that
generates this mail.  Follow this link to all your TCs in OASIS at:
https://www.oasis-open.org/apps/org/workgroup/portal/my_workgroups.php 

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 

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:
> 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 

Michael, I want to respond to your remarks in in individual parts.  I will incorporate the rationale and the restatements in the proposal at 

This is the second response to review of the Version Significance Proposal.  

Update #1 on the beginning of the proposed text is at 

This is the third response to review of the Version Significance Proposal.  

Update #1 on the beginning of the proposed text is at 

This is the fourth response to review of the Version Significance Proposal.  

Update #1 on the beginning of the proposed text is at 

This is the fifth response to review of the Version Significance Proposal.  I also offer some discussion about the appropriateness of the replacement wording that I provide here, and how it fits with the under-development conformance clauses.  Please review those considerations (starting at DISCUSSION), below.

Update #1 on the beginning of the proposed text is at 

This is a complete replacement draft for the January 4 version of the ODF 1.2 Version Significance Proposal.  

This draft contains, below, a complete, lightly-edited version that reflects the review by Michael Brauer on January 6:

The proposal itself, as updated, is at 
http://wiki.oasis-open.org/office/ODF_1.2_Version_Significance 



                                                

					
                                                    

        
                                                
				
                                                

                                                    
                                                        
                                                        Original Message
                                                
                                                Original Message-----
From: Dennis E. Hamilton [mailto:dennis.hamilton@acm.org] 
Sent: Saturday, January 10, 2009 15:25
To: 'ODF TC List'
Cc: 'Rob Weir'; 'Michael Brauer'
Subject: RE: [office] ODF 1.2 Version Significance Proposal - COMPLETE UPDATE

This is a complete replacement draft for the January 4 version of the ODF 1.2 Version Significance Proposal.  

This draft contains, below, a complete, lightly-edited version that reflects the review by Michael Brauer on January 6:

Hi Dennis,

thanks for updating your proposal. I have only a few minor comments 
regarding this updated proposal.

On 01/11/09 00:24, Dennis E. Hamilton wrote:
> 
> [January 10 complete text (in wikiText format)[
> === 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 

Michael, I accept your remarks, and will make the one correction (office:document-content) and the one deletion (regarding later specifications).  I agree that we can let the question of redundancy be resolved when we are reconciling the committee-draft text internally before public review. 

 - Dennis



                                                

					
                                                    

        
                                                
				
                                                

                                                    
                                                        
                                                        Original Message
                                                
                                                Original Message-----
From: Michael.Brauer@Sun.COM [mailto:Michael.Brauer@Sun.COM] 
Sent: Monday, January 12, 2009 04:45
To: dennis.hamilton@acm.org
Cc: 'ODF TC List'; 'Rob Weir'
Subject: Re: [office] ODF 1.2 Version Significance Proposal - COMPLETE UPDATE

Hi Dennis,

thanks for updating your proposal. I have only a few minor comments 
regarding this updated proposal.

On 01/11/09 00:24, Dennis E. Hamilton wrote:
> 
> [January 10 complete text (in wikiText format)[
> === 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 

This is the latest update to the ODF 1.2 Version Significance Proposal.  It reflects my response to Michael Brauer's January 12 comments and the discussion on the January 12 Coordination Call.  The text is also on the wiki at 

As the result of the discussion in the 2009-01-19 coordination call, today, I have updated the Version Significance Proposal to include the caveats that we agreed to.  The new version is at