dido:03-dido-te:99-annexes:annex-b-references:start

This is an old revision of the document!


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.


© 2026 Dido Solutions, Inc. and Jackrabbit Consulting, Inc.

  • dido/03-dido-te/99-annexes/annex-b-references/start.1787529388.txt.gz
  • Last modified: 2026/08/23 16:56
  • by nick_dido