Skip to content

ISODoc: Text Sections

Jump to bottom
Nick Nicholas edited this page Jan 27, 2018 · 20 revisions

sections

sections =
  element sections {
    ( content | clause | terms | annex | references )+
}

section_title =
  element title { text }

content =
  element content {
    attribute id { xsd:ID }?,
    section_title?,
    (
      BasicBlock* |
      content_subsection+
    )
  }

content_subsection =
  element subsection {
    attribute id { xsd:ID }?,
    section_title?,
    (
      BasicBlock* |
      content_subsection+
    )
  }

clause =
  element clause {
    attribute id { xsd:ID }?,
    section_title?,
    (
      BasicBlock* |
      clause_subsection+
    )
  }

clause_subsection =
  element subsection {
    attribute id { xsd:ID },
    section_title?,
    (
      BasicBlock* |
      clause_subsection+
    )
  }


annex =
  element annex {
    attribute id { xsd:ID }?,
    section_title?,
    attribute type ( "normative" | "informative" ),
    ( BasicBlock | clause_subsection+ )
}

references =
  element references {
    attribute id { xsd:ID }?,
    section_title?,
    bibItem*
  }

Items for discussion (threaded: identify by number)

  1. annex/subsection: annexes have subclauses

  2. annex: annex can permit hanging clauses, that can always be tightened in instantiations

    1. You mean "hanging text" right? Agree, fixed in https://github.com/riboseinc/isodoc-models/issues/2

  3. The contents of references are not citation, but bibliographicItem

  4. terms/subsection: the subsections of a Terms section are themselves Terms sections, not clauses

    1. (initially) Agree, fixed in https://github.com/riboseinc/isodoc-models/issues/2

    2. Actually, I don’t think a TermSection should contain another TermSection? A ClauseSection can contain a ClauseSection that contains a TermSection, but not a TermSection within a TermSection since we don’t want a group of terms colliding with term definitions. A TermSection should be a terminal section?

    3. TermSections do contain subsections per ISO/IEC DIR 2: 16.4. "Subdivision of the terms and definitions clause is permitted." Example 2 gives: "3. Terms and definitions" follows by "3.2 Surface properties"; "Surface properties" is itself a terms and definitions section.

Clone this wiki locally