Annex B: References

Go to Annexes

Annex B identifies the references used by the Distributed Immutable Data Object Test Environment (DIDO-TE).

Each DIDO-TE-specific reference has a stable identifier and URI so requirements, architecture sections, definitions, information-model elements, and other records can cite source material consistently.

DIDO-TE-specific references use identifiers in the form [DTEn], where n is the assigned reference number.

Individual reference pages are leaf pages and use namespaces in the form:

dte-NNN

The reference identifier remains stable throughout the lifecycle of the reference.

Citations use the stable reference identifier followed by the most precise applicable source location.

For example:

[[dido:03-dido-te:99-annexes:annex-b-references:dte-002|[DTE2]]], Section 2.1.1.

For model-based references, cite [DTE4] DIDO Reference Data Model followed by the most precise model location available.

A model citation may identify:

• a package;
• a diagram;
• a model element;
• a datatype;
• an attribute;
• an association;
• a relationship;
• a multiplicity; or
• another identifiable model construct.

For example:

[[dido:03-dido-te:99-annexes:annex-b-references:dte-004|[DTE4]]], model element //Test Plan//.

A more precise model citation may include the model path:

[[dido:03-dido-te:99-annexes:annex-b-references:dte-004|[DTE4]]], //DIDO - RI::DIDO - Conceptual Model::Community::Testing Package::Test//.

Where a DIDO-TE Information Model page documents a relationship, attribute, multiplicity, or other structure extracted from the DIDO Reference Data Model, the page cites [DTE4] and identifies the applicable source-model location.

DIDO-TE architectural interpretations, refinements, and extensions are distinguished from structures directly represented by [DTE4].

Assign each new DIDO-TE-specific reference the next available DTE identifier.

Maintain each reference as a separate leaf page with a stable URI.

Do not reuse or renumber an assigned reference identifier.

Use the reference page as the canonical citation target.

Identify the most precise source location available when deriving a requirement or architectural statement from a reference.

For model citations, use [DTE4] as the canonical source reference and identify the applicable package, diagram, model element, datatype, attribute, association, multiplicity, or model path.

Do not represent a DIDO-TE refinement or extension as though it were present in [DTE4]. Distinguish source-model content from DIDO-TE architectural interpretation.

Preserve source-model names, spellings, relationships, and multiplicities when documenting the source model unless an explicit DIDO-TE refinement is identified.

Preserve historical references when existing requirements, evidence, reports, or externally published documents cite an earlier revision.

When a referenced source is superseded, record the supersession relationship on the applicable reference page.

Do not rename a reference page after external citation unless a redirect or move plan is in place.