Uploaded image for project: 'OASIS Open Document Format for Office Applications (OpenDocument) TC'
  1. OASIS Open Document Format for Office Applications (OpenDocument) TC
  2. OFFICE-1461

Public Comment: Unacceptable presentation of content models (ODF 1.2CD01r5)

    Details

    • Type: Bug
    • Status: Applied
    • Priority: Major
    • Resolution: Fixed
    • Affects Version/s: ODF 1.2
    • Fix Version/s: ODF 1.2
    • Component/s: Schema and Datatypes
    • Labels:
      None
    • Proposal:
      Hide

      See Michael's comment

      Show
      See Michael's comment
    • Resolution:
      Hide

      Inserted Michael's suggestion in 1.2 Notation.

      Show
      Inserted Michael's suggestion in 1.2 Notation.

      Description

      Copied from office-comment list

      Original author: "Alex Brown" <alexb@griffinbrown.co.uk>
      Original date: 14 Apr 2009 20:12:00 -0000
      Original URL: http://lists.oasis-open.org/archives/office-comment/200904/msg00015.html

        Attachments

          Activity

          Hide
          michael.brauer Michael Brauer (Inactive) added a comment -

          ODF 1.0 and ODF 1.2 did contain the schema in Relax-NG XML syntax. Using RNG Compact as suggested would be equivalent, except that the notation would be more compact.

          Including the schema into the specification, regardless which syntax is used, has the disadvantage that the specification structure has to follow the structure of the schema, which is not always appropriate. For that reason, the schema is not embedded in the specification any longer in ODF 1.2, but available as a separate document.

          The paragraphs with the orange background color have been added to provide cross references between the elements and attributes. They are informative, and are not an attempt to repeat what is said formally in the schema in by natural language.

          What is missing in indeed missing is an explanatory sentence in the notation section of the specification. Further, the formatting of the informative paragraphs should be changed.

          Show
          michael.brauer Michael Brauer (Inactive) added a comment - ODF 1.0 and ODF 1.2 did contain the schema in Relax-NG XML syntax. Using RNG Compact as suggested would be equivalent, except that the notation would be more compact. Including the schema into the specification, regardless which syntax is used, has the disadvantage that the specification structure has to follow the structure of the schema, which is not always appropriate. For that reason, the schema is not embedded in the specification any longer in ODF 1.2, but available as a separate document. The paragraphs with the orange background color have been added to provide cross references between the elements and attributes. They are informative, and are not an attempt to repeat what is said formally in the schema in by natural language. What is missing in indeed missing is an explanatory sentence in the notation section of the specification. Further, the formatting of the informative paragraphs should be changed.
          Hide
          michael.brauer Michael Brauer (Inactive) added a comment -

          Suggestion:

          The informative element and attribute lists may get a border. The background color may be change to a 10% gray, or even transparent.

          In section 1.6 Notation, we may add:

          Text with a gray background color which is contained in boxes is informative. It lists the element-element and element-attribute relations for cross reference purposes.

          Show
          michael.brauer Michael Brauer (Inactive) added a comment - Suggestion: The informative element and attribute lists may get a border. The background color may be change to a 10% gray, or even transparent. In section 1.6 Notation, we may add: Text with a gray background color which is contained in boxes is informative. It lists the element-element and element-attribute relations for cross reference purposes.
          Hide
          patrick Patrick Durusau added a comment -

          Correction will appear in OpenDocument-v1.2-part-1-cd03-rev03.

          Show
          patrick Patrick Durusau added a comment - Correction will appear in OpenDocument-v1.2-part-1-cd03-rev03.
          Hide
          michael.brauer Michael Brauer (Inactive) added a comment -

          For part 3, I've inserted an "XML" in the 2nd sentence. The full section "Notation", which is now called "Terminology", reads as follows:

          All text is normative unless otherwise labeled.
          Text with a gray background color which is contained in boxes is informative. It lists the XML element-element and element-attribute relations for cross reference purposes.
          Within the normative text of this specification, the terms "shall", "shall not", "should", "should not", "may" and "need not" are to be interpreted as described in Annex H of [ISO/IEC Directives].
          XML Element and attribute names as well as attribute value types and values appear in a monospace font.

          Show
          michael.brauer Michael Brauer (Inactive) added a comment - For part 3, I've inserted an "XML" in the 2nd sentence. The full section "Notation", which is now called "Terminology", reads as follows: All text is normative unless otherwise labeled. Text with a gray background color which is contained in boxes is informative. It lists the XML element-element and element-attribute relations for cross reference purposes. Within the normative text of this specification, the terms "shall", "shall not", "should", "should not", "may" and "need not" are to be interpreted as described in Annex H of [ISO/IEC Directives] . XML Element and attribute names as well as attribute value types and values appear in a monospace font.

            People

            • Assignee:
              patrick Patrick Durusau
              Reporter:
              rcweir Robert Weir (Inactive)
            • Watchers:
              0 Start watching this issue

              Dates

              • Created:
                Updated:
                Resolved: