Re: Next steps questions for ODF 1.3

[Paul Knight <paul.knight@oasis-open.org>]

Hi Svante and all,

Sorry that what I had written did not communicate fully:

When I wrote [in the earlier email]

"DON'T change the file names inside the /schemas directory"

I was referring ONLY to the eight files listed in the directory "schemas" - as seen in https://docs.oasis-open.org/office/OpenDocument/v1.3/csd03/schemas/

(background: - these schema file names had initially contained a "-csd03" component when submitted for publication, which was removed during publication)

PLEASE DO change the file names for the four main Parts before submitting for publication - they should match the URIs listed on the front page. (However, that can be done later, afterÂthis review. During this internal review, it does not matter - please don't feel that you have to disrupt this review toÂchange the file names!)

Best regards,

Paul

On Fri, Oct 9, 2020 at 8:52 AM Svante Schubert <svante.schubert@gmail.com> wrote:

Dear TC members, Dear Paul,

I believe I have added all the required changes and created a GitHub Pull-Request, which yet have to be reviewed:

https://github.com/oasis-tcs/odf-tc/pull/30ÂÂ

As Paul requested, I have not changed the file names but created a new CS02 directory for our deliverables.

To be able to view the HTML at the GitHub side, I was using my own GitHub fork, you might view already the HTML directly beyond:

1. https://svanteschubert.github.io/odf-tc/odf1.3/cs02/OpenDocument-v1.3-csd03-part1-introduction.html
   
2. https://svanteschubert.github.io/odf-tc/odf1.3/cs02/OpenDocument-v1.3-csd03-part2-packages.html
   
3. https://svanteschubert.github.io/odf-tc/odf1.3/cs02/OpenDocument-v1.3-csd03-part3-schema.html
   
4. https://svanteschubert.github.io/odf-tc/odf1.3/cs02/OpenDocument-v1.3-csd03-part4-formula.html
   

The PDFs are updated as well and can be downloaded via the deliverables directory:

https://github.com/svanteschubert/odf-tc/tree/master/docs/odf1.3/cs02

A short oversight over the changes is given in the GitHub pull-request.

If there is anything missing, please let me know.

Best regards,

Svante

Am Mi., 7. Okt. 2020 um 21:11ÂUhr schrieb Paul Knight <paul.knight@oasis-open.org>:

Hi Patrick,

I don't see any blocking issues here - sounds pretty good. More details in-line below...

On Wed, Oct 7, 2020 at 2:13 PM Patrick Durusau <patrick@durusau.net> wrote:

Paul,

1) The TC has discovered that in the most recent public review, section
5.5.1 General of part 3 read:

"The under-specification of change tracking in ODF 1.2 resulted in a
number of different choices being possible as to how to implement the
feature. While each of these choices would be consistent with the way
that the feature is specified, unless identical choices are made, it is
likely that the resulting implementations would not be fully
interoperable. For this reason, where interoperability of change
tracking between implementations is required, implementers are
recommended to carry out specific checks that their implementation
choices are the same or similar enough to be interoperable."

That language was changed in our drafts and should have read:

""The under-specification of change tracking in ODF 1.2 resulted in
varying implementations of this feature. Where interoperability between
implementations is required, this feature should be checked for
interoperability."

See: https://issues.oasis-open.org/browse/OFFICE-3873

The TC sees this as an editorial error to be noted to the TC Admin.

Will that be a problem?

PK> The overriding issue here is the simpleÂquestion: Is this a "material" change?

The TC Process [1] positions this as something that the TC must decide, based on the definition:

"Material Change" is any change to the content of a Work Product that would require a compliant application or implementation to be modified or rewritten in order to remain compliant or which adds new features or otherwise expands the scope of the work product.

Then you just follow the TC Process for a Committee specification [2]:

If Non-Material Changes have been made to the draft since its last public review then the TC must provide an acceptable summary that is clear and comprehensible of the changes made since the last public review and a statement that the changes are all Non-Material to the TC Administrator.

You are fairly familiar withÂthis, I think, especially since you mention the "proper forms about comments and changes"....

[1]Âhttps://www.oasis-open.org/policies-guidelines/oasis-defined-terms-2018-05-22#dMaterialChange

[2]Âhttps://www.oasis-open.org/policies-guidelines/tc-process-2017-05-26#committeeSpec

2) The TC received one comment,
https://issues.oasis-open.org/browse/OFFICE-4094, that does identify an
error in the spec, but it is one that has existed since 1.2 and so far
as we can tell, no implementer has followed our advice. Quite possibly
because what we say makes no sense for time calculations.

We intend to respond by acknowledging the error and setting it to ODF 1.4.

Will that suffice?

PK> Sure, just include the details into the comment resolution log file. It should be clear enough so that if the commenter asks about it, you can simply say - "please look in the comment resolution log." That is, include a link to the issue and the email (unless that's in the issue), and the TC's decision. If it's in the TC meeting minutes,, you can point to that, or to related emails, if you want.

3) Svante wants to know what changes need to be made to prepare the
texts for the TC vote to make 03 the Committee Specification (contingent
on our supplying the proper forms about comments and changes.)

PK> Well, this involves very few changes beyond changing all of the "csd03" URIs to point to "cs02" instead. (of course, both the visible URI text and its hyperlink must change.

- Also change the "Previous stage" URIs to point to csd03 (i.e., just copy "This stage" of the csd03 docs to "Previous stage" of the cs02 documents)

- Be sure to update the "Citation format" and "Additional artifacts" links.

- no need to change "Latest stage" links anywhere.

PK>Â One item of particular note is:

- DON'T change the file names inside the /schemas directory to include any "stage" name component. I corrected these file names in publishing csd03. (Apologies to Svante for maybe not communicating clearly about this earlier - I think it got lost due to answering a second question shortly afterward... (https://lists.oasis-open.org/archives/office/202008/msg00041.html)).

- If you want to update the commented header material in the /schemas files, you can do that. I'll also checkÂduring publication.

I think that covers most of it...

Thanks!

Hope you are having a great week!

Patrick

Thanks - good so far!

Best regards,

PaulÂ

--
Patrick Durusau
patrick@durusau.net
Technical Advisory Board, OASIS (TAB)
Editor, OpenDocument Format TC (OASIS), Project Editor ISO/IEC 26300
Co-Editor, ISO/IEC 13250-1, 13250-5 (Topic Maps)

Another Word For It (blog): http://tm.durusau.net
Homepage: http://www.durusau.net
Twitter: patrickDurusau

--

Paul Knight....Document Process Analyst

OASIS - Advancing open standards for the information society

--

Paul Knight....Document Process Analyst

OASIS - Advancing open standards for the information society