Comments from Jacques Durand on ODF for Office Applications Part 1

["Jacques R. Durand" <JDurand@us.fujitsu.com>]

Review of specification:

Open Document Format for Office Applications (OpenDocument) Version 1.2
Part 1: Introduction and OpenDocument Schema

(by TAB member: Jacques Durand)

-----------------------------------------------------------------------------------

[1]- p83: Section 2 "Scope" seems to be incomplete.

 

[2]- the labels for columns in Table 6 should be concisely explained/defined in a

small terminology list in same section.

 

[3]- section 3.16 Document and Macro Signatures

could be more clearly retitled: "Document Signature and Macro Signature" ?

 

[4]- section  3.1.3.2 and similar sections: the expression "package file" is misleading as it

may suggest that the "file" is a "package" which is not the case:

"...The package file for the <office:document-content> is content.xml. ..."

Instead, we are talking of a file inside a package:

how about "...The package component file for the..."

 

[5]- section  7.4.1: In: "...The variable declarations are collected in container elements

for the each variable type. "

remove "the" in "..for [the] each variable..."

 

[6]- Conformance Clause (1):

D1.2.2. " XML root elements of the files shall be ..."

Is an ODF package allowed to contain other additional files besides content.xml, meta.xml, etc?

(non described in this specification)?

This conf clause does not prohibit that, I assume it is OK (D.1.1.2 suggests it).

If yes, that should be made clearer and also why that may be useful.

 

[7]- Conformance Clause (2):

D1.2: "If the document is an OpenDocument package, then the following requirements shall be met...

for its contained files named ..."

The Clause should probably say that in addition:

"each file's content shall adhere to the requirements in this specification

that are related to its XML root element (in addition to schema validation)".

There are indeed requirements that are not entirely captured by schema validation

(e.g. well-formedness of marks and indexes, etc.)

 

[8]- Conformance Clause (3):

P1.1: "(P1.1) It shall not produce any non-conforming OpenDocument document of any kind."

That is a strange requirement: what is a "non-conforming OpenDocument document "?

DO we mean here more precisely: "shall not produce any document containing ODF namespaces,

that is not itself a conforming OpenDocument document."

(NOTE: an exception to this could be that the Producer may produce some folder document

or some manifest that contains ODF namespaces, e.g. referencing existing ODF docs.)

 

[9]- Conformance Clause (4): Consumer Conformance

(C1) "A Conforming OpenDocument Consumer is a program that can parse and interpret

OpenDocument documents, and that meets the following additional requirements:"

The notion of "interpeting" and ODF doc should be better defined.

Are we talking of some kind of "rendering"? According to what rules?