DTV — Date-Time Issue: CLIF file should include metadata

The machine-readable CLIF file contains the CLIF axioms mechanically stripped out of the specification document. Currently, it is very difficult to trace back from the individual CLIF file entries to the matching source entries in the document. The CLIF file should include metadata (presumably as annotations) that relate each axiom to the appropriate place in the document.

In the CLIF and OCL machine-readable files, the text of the preceding SBVR Definition or Necessity caption is inserted as a comment in front of each CLIF axiom or OCL constraint. This provides traceability from the CLIF and OCL entries back to the specification document.

The following metadata is added to the start of both the CLIF and OCL machine-readable files, each as commentary in the syntax appropriate to each file format. This metadata is modeled after the proposal by Elisa Kendall to the OMG Architecture Board.

• moduleName: Date-Time Vocabulary
• moduleAbbreviation: DTV
• moduleVersion: 1.0
• moduleAbstract: This file contains CLIF (or OCL) for portions of the Date-Time Vocabulary. See http://www.omg.org/spec/DTV.
• filename: dtv.clif
• documentNumber: dtc/2012-10-12
• documentURL: http:/www.omg.org/spec/DTV/20121201/dtv.clif
• isNormative: true
• contentType: vocabulary
• contentLanguage: http://standards.iso.org/ittf/PubliclyAvailableStandards/c039175_ISO_IEC_24707_2007%28E%29.zip
• format: CLIF
• directSource: http:/www.omg.org/cgi-bin/doc?dtc/2012-10-09
• copyright: Copyright (c) 2012, Object Management Group