OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.

 


Help: OASIS Mailing Lists Help | MarkMail Help

office-comment message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]


Subject: Unacceptable presentation of content models (ODF 1.2CD01r5)


Dear all,

I have just taken a quick look at the new (rev5) draft of 1.2.

The presentation of content models (text on a peach background) is still
completely unacceptable, and this draft is consequently still mostly one
enormous defect.

For the spec say (as it does) "the element [x] is usable used with the
following elements" makes no sense. And assuming you delete the spurious
word 'usable' the statement is still way too loose and casual for a
normative statement of an element's "upward" content model, since there
will be constraints upon how that element's parent may come to contain
the element in question as a child.

The draft also states throughout that "The [x] element has the following
child element(s)". But in *reality* your content models allow choice,
sequencing, grouping, etc. But you have invented a prose schema language
which loses all this vital information and lossily dumbs it down.

This is a serious systematic fault in this draft and fiddling around
with the wording is not going to cure it: you need to find an accurate
and lossless way to represent the content models of elements you are
normatively describing - and just such a thing already exists in RNG
compact syntax.

Likewise, it is unacceptable to state of an element "The [x] element has
the following attributes." What you mean is that the [x] element is
declared to have attributes with the following names. And then we (the
readers) need to know which are optional, which are mandatory, and what
their datatypes are. Again, RNG compact will concisely convey just this
information.

- Alex.


[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]