CDR: style and precision problems in definitions appendix

A.

"Compound Document

The compound document is a document that combines separate component  
languages either by reference or by inclusion."

- I think this would be better written as:

    "Compound Document

     A compound document is a document that combines multiple  
document formats by reference, by inclusion or both."

   Or it may be even better to say "one or more document formats"


"A parent document represents a document that has a DOM as defined by  
DOM Level 3 Core and reference another document. The DOM that is  
formed must be tree-based."

- That should be "references another document".

- Stating that "The DOM that is formed must be tree-based" is vacuous  
- the DOM is always tree-based.

"The document that is referenced is called Child document. If the  
Child document references other documents, it is also called Parent  
document."

- Suggest rewriting for style to say "The document that is referenced
   is called a child document. If a child document itself references
   other documents, then it is also a parent document."

"Component Language

Component language refers to an XML-based language (like XHTML and  
SVG) with its own elements and attributes."

- Perhaps the term "XML Application" would be sufficient to express  
this, instead of the novel term "Component Language".

- Is non-X HTML meant to be explicitly included by this  
specification? I would prefer if it were included as a valid format  
that can participate in CDR.


"CDR
A document which logically includes other documents via a hypertext  
reference.

For example: XML 1.1 or HTML documents tied through hypertext  
reference producing as many DOM linked to one another."

- The example doesn't make sense as English. No correction offered  
because I am not sure what it is supposed to mean.

- CDR expands to Compound Document by Reference, it may be worth  
including this expansion in the definition.

"CDI
A document which includes other documents by-value.

For example: A single XML 1.1 document making use of XML grammars
defined independently, normally making use of multiple namespaces."

- Instead of "by-value" it may help to use a more clear term, like  
"textually include" or "directly include".

- CDR expands to Compound Document by Inclusion, it may be worth  
including this expansion in the definition.

Regards,
Maciej

Received on Monday, 2 January 2006 10:09:38 UTC