Differences

This shows you the differences between two versions of the page.

--- dido:03-dido-te:99-annexes:annex-b-references:start [2026/08/19 18:44] – nick_dido
+++ dido:03-dido-te:99-annexes:annex-b-references:start [2026/08/23 16:57] (current) – nick_dido
@@ Line 5: / Line 5: @@
 Annex B identifies the references used by the [[dido:99_annexes:annex-b-terms-and-definitions:d:dido-te|Distributed Immutable Data Object Test Environment (DIDO-TE)]].
-Each DIDO-TE-specific reference has a stable identifier and URI so requirements, architecture sections, definitions, and other records can cite source material consistently.
+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.
@@ Line 19: / Line 19: @@
 ===== References =====
-  * [[dido:03-dido-te:99-annexes:annex-b-references:dte-001|[DTE1] U.S. Patent Application US20220237111A1]]
+{{indexmenu>dido:03-dido-te:99-annexes:annex-b-references#1|js navbar nocookie maxjs#2 id#dido_te_annex_b_references_nav}}
-  * [[dido:03-dido-te:99-annexes:annex-b-references:dte-002|[DTE2] Non-Traditional BAA Submission]]
-  * [[dido:03-dido-te:99-annexes:annex-b-references:dte-003|[DTE3] Draft BAA White Paper]]
-  * [[dido:03-dido-te:99-annexes:annex-b-references:dte-004|[DTE4] DIDO Reference Data Model]]
-  * [[dido:03-dido-te:99-annexes:annex-b-references:dte-005|[DTE5] DIDO-TE Requirements Register]]
-  * [[dido:03-dido-te:99-annexes:annex-b-references:dte-006|[DTE6] Structured Information Processing Reference Architecture (SIP-RA)]]
-  * [[dido:03-dido-te:99-annexes:annex-b-references:dte-007|[DTE7] Federated Data Interpretation Systems Reference Architecture (FDIS-RA)]]
-  * [[dido:03-dido-te:99-annexes:annex-b-references:dte-008|[DTE8] Reference Architecture Description]]
 ===== Citation Use =====
@@ Line 38: / Line 31: @@
 </code>
-A citation to a model identifies the applicable package, diagram, model element, datatype, attribute, association, or other relevant model element.
+For model-based references, cite [[dido:03-dido-te:99-annexes:annex-b-references:dte-004|[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:
@@ Line 46: / Line 51: @@
 </code>
-===== Contents =====
+A more precise model citation may include the model path:
-{{indexmenu>dido:03-dido-te:99-annexes:annex-b-references#1|js navbar nocookie maxjs#2 id#dido_te_annex_b_references_nav}}
+<code dokuwiki>
+[[dido:03-dido-te:99-annexes:annex-b-references:dte-004|[DTE4]]], //DIDO - RI::DIDO - Conceptual Model::Community::Testing Package::Test//.
+</code>
+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].
 ----
@@ Line 63: / Line 74: @@
 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.