Uploaded image for project: 'Specification'
  1. SPEC-284

Correct inconsistencies in naming of term_definitions, constraint_definitions, term_bindings and constraint_bindings attributes in XML-schema and specifications

    Details

    • Change Description:
      Hide

      This problem should be corrected as follows:

      • treat the XML-schema as being correct (it has the more expected plural spellings of the attributes). It also corresponds to the AOM and thus ISO/EN13606 form of the names.
      • correct the ADL specification to use the plural spelling for term_definitions, constraint_definitions, term_bindings and constraint_bindings sections in the ontology.
      • correct the archetype tools to allow both spellings in ADL archetypes, and to silently convert singular -> plural on saving.
      • correct spellings in examples in Architecture Overview specification
      Show
      This problem should be corrected as follows: treat the XML-schema as being correct (it has the more expected plural spellings of the attributes). It also corresponds to the AOM and thus ISO/EN13606 form of the names. correct the ADL specification to use the plural spelling for term_definitions, constraint_definitions, term_bindings and constraint_bindings sections in the ontology. correct the archetype tools to allow both spellings in ADL archetypes, and to silently convert singular -> plural on saving. correct spellings in examples in Architecture Overview specification
    • Impact Analysis:
      Hide

      Apart from minor changes to the specifications, there will be some minor changes required in the archetype editing tools.

      Show
      Apart from minor changes to the specifications, there will be some minor changes required in the archetype editing tools.
    • Approved By:
      ARB

      Description

      Alessandro Torrisi (Unusual Visions, implementing at Medical Centre Alkmaar, The Netherlands) reported the following inconsistency.

      The ADL 1.4 specification mentions subsections under the archetype ontology section named term_binding and constraint_binding (both singular). In the AOM specification, these attributes are not defined (already raised as an issue), although there are invariants that imply the presence of attributes term_bindings and constraint_bindings (both plural).

      In ADL archetypes, these two attributes occur in a small number of archetypes, and are named in the singular.

      In the published AOM XML-schema, these attributes are spelled in the plural form. XML archetypes include these attributes named in the plural.

      There is a similar minor inconsistency in the attribute names term_definition(s) and constraint_definition(s) in the ADL 1.4 specification; again both of these should be in the plural. They already appear in the plural in ADL archetypes, the XML-schema, and XML archetypes, so this anomaly is essentially just a typographical error in the ADL specification only.

      The architectural overview document also includes a couple of instances of these spelling errors in examples.

        Attachments

          Activity

              People

              • Assignee:
                Unassigned
                Reporter:
                Thomas Beale
                Raised By:
                Thomas Beale
                Analyst:
                Rong Chen (Inactive), Thomas Beale
              • Votes:
                0 Vote for this issue
                Watchers:
                0 Start watching this issue

                Dates

                • Due:
                  Created:
                  Updated:
                  Resolved: