Annex B: References

Go to Annexes

Annex B identifies the references used by the DIDO Test Environment (DIDO-TE) documentation, requirements register, architecture descriptions, testing guidance, and supporting artifacts.

Each reference resides on a separate wiki page with a stable identifier and URI. DIDO-TE pages use these stable identifiers to cite source material consistently.

DIDO-TE-specific references use identifiers in the form:

• [DTE1]
• [DTE2]
• [DTE3]
• [DTE4]

The corresponding namespaces use the stable numeric identifier rather than the document title.

Examples include:

• dido:03-dido-te:99-annexes:annex-b-references:dte-001
• dido:03-dido-te:99-annexes:annex-b-references:dte-002
• dido:03-dido-te:99-annexes:annex-b-references:dte-003
• dido:03-dido-te:99-annexes:annex-b-references:dte-004

Reference pages are leaf pages and therefore omit a trailing :start.

The descriptive document or artifact title appears in the reference-page heading and in the References list.

• [DTE1] U.S. Patent Application US20220237111A1
• [DTE2] Non-Traditional BAA Submission
• [DTE3] Draft BAA White Paper
• [DTE4] DIDO Reference Data Model
• [DTE5] DIDO-TE Requirements Register

DIDO-TE pages cite a reference by linking its stable identifier.

For example, a requirement Derived From section uses:

[[dido:03-dido-te:99-annexes:annex-b-references:dte-001|[DTE1]]], Claim 1.

When a citation refers to a specific location within a textual source, the citation identifies the applicable section, clause, page, paragraph, claim, figure, table, or requirement following the reference link.

For example:

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

A citation to the DIDO Reference Data Model identifies the applicable diagram, package, model element, datatype, attribute, association, or other model element.

For example:

[[dido:03-dido-te:99-annexes:annex-b-references:dte-004|[DTE4]]], UML Class Diagram, //Test Environment Package//.

A citation to a specific model element uses:

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

A citation to a conceptual datatype uses:

[[dido:03-dido-te:99-annexes:annex-b-references:dte-004|[DTE4]]], conceptual datatype //yes_no_type//.

Exported diagrams derived from the DIDO Reference Data Model serve as documentation figures or model views. They do not constitute separate Annex B references unless an exported diagram has independent authority, provenance, or revision control.

A caption for an exported diagram identifies [DTE4] as its source.

For example:

Figure X: Test Environment Package class diagram exported from [[dido:03-dido-te:99-annexes:annex-b-references:dte-004|[DTE4]]].

[DTE4] records a conceptual model. Its datatypes define semantic meaning and value spaces without prescribing logical or physical representations.

DIDO-TE documentation preserves the following model hierarchy:

• The Conceptual Model defines implementation-independent meaning and semantic distinctions.
• A Logical Model maps conceptual elements and datatypes to implementable logical representations.
• A Physical Model maps logical representations to concrete platform-specific datatypes, encodings, constraints, and structures.

Requirements derived from [DTE4] identify the applicable source element and document any normalization applied to its name or expression.

Corrections to spelling, capitalization, or naming conventions do not alter the historical source. The requirement or model derivation record identifies both the original source name and its normalized name.

For example:

An editorial correction preserves the source meaning. A change to a datatype's values, relationships, constraints, or semantics constitutes a model change and requires an explicit rationale and traceable disposition.

Maintain each reference as a separate linked wiki page with a stable URI.

Assign each new DIDO-TE-specific reference the next available identifier in the sequence [DTE1], [DTE2], [DTE3], and so forth.

Use leaf namespaces in the form:

• dte-001
• dte-002
• dte-003
• dte-004

Do not include the document title in the namespace.

Do not append :start to an individual reference page. The Annex B index page is a non-leaf page and retains :start:

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

Use reference-page headings in the form:

• ====== [DTE1] Document Title ======
• ====== [DTE2] Document Title ======
• ====== [DTE3] Document Title ======
• ====== [DTE4] Artifact Title ======

Use the reference page as the canonical citation target rather than repeating the complete bibliographic citation throughout the DIDO-TE documentation.

Identify the precise source location whenever a requirement derives from a reference. Do not cite only the reference identifier when a more precise section, clause, paragraph, claim, figure, diagram, package, or model element is available.

Treat a native model file as the source artifact. Treat diagrams exported from the model as views of that source unless an export has independent authority, provenance, or revision control.

Do not treat historical model content as a current normative requirement without analysis, normalization, traceability, review, and approval.

Preserve the spelling and terminology found in the historical source when recording provenance. Apply corrected and normalized terminology in current DIDO-TE requirements, definitions, and architecture content.

Document every correction by recording the original source expression and the normalized expression. Do not classify a semantic change as an editorial correction.

Preserve the distinction between conceptual, logical, and physical models. Do not add implementation-specific datatypes, encodings, products, or technologies to a conceptual-model requirement.

When a new revision supersedes a referenced document or model, update the applicable reference page with its version, revision, date, status, and supersession relationship.

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

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