Re: Fwd: [office] Groups - ODF 1.0 errata 2 - draft02 (OpenDocument-v1.0-errata02-ed02.odt) uploaded

[robert_weir@us.ibm.com]

Note that we also need to connect to JTC1 Directives at some point, in 
particular 15.4.9.4.5 "Each technical corrigendum shall list the status of 
all amendments and technical corrigenda to the current edition of the 
standard."  So on the JTC1 side, the convention is to publish multiple 
technical corrigenda, as separate documents, each of which states how it 
relates to other published amendments and corrigenda.

It isn't clear whether the OASIS vision of Approved Errata is to do this 
as well, e.g., Approved Errata 02 includes by reference Approved Errata 
01.  Or whether Approved Errata 02 is a revision of the Approved Errata 01 
text.

Note that OASIS's commitment to JTC1 call for us to maintain technically 
equivalent specifications in both organizations.  This will be hard to do 
if JTC1 has a separate citable ISO/IEC 26300:2006/Cor. 1 and ISO/IEC 
26300:2006/Cor. 2, while we have only a single Approved Errata document 
which is revised every 6 months, and older versions cannot be reliably 
cited.

So I am hoping that ODF 1.0 Approved Errata 02 states that it applies to a 
ODF 1.0 as corrected by Approved Errata 01.  Future Approved Errata 
similarly state that Approved Errata N assume that Approved Errata 01 - 
Approved Errata N-1 have already been applied.  That gives a well-defined 
text to which Approved Errata N will be applied.

Of course the critical case is where the same part of the specification is 
corrected more than once.  This should happen only rarely, but doing this 
well is the acid test for any process around errata/corrigenda.

So imagine we have ODF 1.0:

"The fo:bar attribute gives the value of the angel in radians from 0-180"

We correct that in Approved Errata 01 with the statement:

"Replace ''angel in radians' with 'angel in degrees' "

We then notice that we used the wrong word, 'angel' rather than 'angle'. 
We correct that with Errata 02:

"Replace 'angel' with 'angle'"

Note that this is all deterministic. Apply each errata in order.  Some may 
change the same text and wipe out earlier changes.  But it is all 
deterministic and reproducible.

The problem would come if you try to combine two sets of editing changes 
into one giant errata document, and do something like sort by clause.  You 
could then end up applying changes in the wrong order.  For example, if 
"Replace 'angel' with 'angle'" is done first, then you would be unable to 
do "Replace ''angel in radians' with 'angel in degrees' ", since that text 
pattern can no longer be matched.

I certainly like the idea of a cumulative list of corrections,  but I 
think you accomplish that with clearly numbered Approved Errata, each one 
of which states that it includes by reference the previous ones.  That 
gives us a deterministic way of determining the corrected text as well as 
giving us one-to-one correspondence with the parallel ISO corrigenda.

-Rob


Svante.Schubert@Sun.COM wrote on 02/01/2010 08:24:15 AM:
> 
> Hello Mary,
> 
> I am the editor of the errata02 and as I am new in editor business, 
> I got a basic question:
> 
> Do I have to copy/paste the errata01 into the errata02?
> Or is a reference to the previous errata in the header of errata02 
sufficient?
> 
> Many thanks for your help!
> Svante
> 
> 
> -------- Original Message -------- 
> 
> Subject: 
> 
> [office] Groups - ODF 1.0 errata 2 - draft02 (OpenDocument-v1.0-
> errata02-ed02.odt) uploaded
> 
> Date: 
> 
> Fri, 29 Jan 2010 14:41:39 +0000
> 
> From: 
> 
> Svante.Schubert@Sun.COM
> 
> To: 
> 
> office@lists.oasis-open.org
> 
> 

> The document revision named ODF 1.0 errata 2 - draft02
> (OpenDocument-v1.0-errata02-ed02.odt) has been submitted by Mr. Svante
> Schubert to the OASIS Open Document Format for Office Applications
> (OpenDocument) TC document repository.  This document is revision #1 of
> OpenDocument-v1.0-errata-02-100124.odt.
> 
> Document Description:
> This is the second errata draft of the upcoming OpenDocument Format 1.0
> Errata 02.
> An upcoming TC vote on a CD may base on it.
> 
> There have been five comments so far on the errata02 from Patrick and
> Michael:
> 
> 1. Comment:
> http://lists.oasis-open.org/archives/office/201001/msg00250.html
>   Amendment: Changed second column header from 'Section Refinement' to 
'Sub
> Heading'
> 2. Comment:
> http://lists.oasis-open.org/archives/office/201001/msg00252.html
>   Amendment: In 15.14.12 changed 'repeated' to 'repeat'
> 3. Comment:
> http://lists.oasis-open.org/archives/office/201001/msg00253.html
>   Amendment: Shall there be an editors action?
> 4. Comment:
> http://lists.oasis-open.org/archives/office/201001/msg00289.html
>   Amendment: Changed 'implementation defined' to 'implementation 
dependent'
> in the notes.
>   Shall the wording in ODF 1.0 changed as well?
> 5. Comment:
> http://lists.oasis-open.org/archives/office/201001/msg00404.html
>   Amendments:
>    a) In 7.7.1 the new text was changed to the ODF 1.2 wording
>    b) In 8.4.3 wording was corrected according suggestion.
>    c) In 8.5 wording was corrected according suggestion.
> 
> Furthermore, I have overworked the abstract, copyright year and went
> through 
> http://docs.oasis-open.org/templates/QAChecklistV3.html
> 
> Changes that will happen when the draft becomes a Committee Draft:
> - In the header 'Draft 02' will be change to 'Committee Draft 01'
> - The document date will change to the approval date
> - URL references might change according to Mary's feedback 
> 
> Regards,
> Svante
> 
> 
> View Document Details:
> http://www.oasis-open.org/committees/document.php?document_id=36159
> 
> Download Document: 
> http://www.oasis-open.org/committees/download.php/36159/
> OpenDocument-v1.0-errata02-ed02.odt
> 
> Revision:
> This document is revision #1 of OpenDocument-v1.0-errata-02-100124.odt. 
> The document details page referenced above will show the complete 
revision
> history.
> 
> 
> PLEASE NOTE:  If the above links do not work for you, your email 
application
> may be breaking the link into two pieces.  You may be able to copy and 
paste
> the entire link address into the address field of your web browser.
> 
> -OASIS Open Administration