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:
      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 Thomas Beale
              Raised By:
              Thomas Beale
              Analyst:
              Rong Chen, Thomas Beale
            • Votes:
              0 Vote for this issue
              Watchers:
              0 Start watching this issue

              Dates

              • Due:
                Created:
                Updated:
                Resolved: