Differences

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

--- dido:03-dido-te:99-annexes:annex-b-references:start [2026/08/07 08:04] – created nick_dido
+++ dido:03-dido-te:99-annexes:annex-b-references:start [2026/08/19 18:48] (current) – nick_dido
@@ Line 3: / Line 3: @@
 [[dido:03-dido-te:99-annexes:start|Go to Annexes]]
-Annex B contains the references used by the DIDO Test Environment (DIDO-TE) documentation, requirements register, architecture descriptions, testing guidance, and supporting artifacts.
+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 reference resides on a separate wiki page with a stable identifier and URI so that DIDO-TE pages cite the source consistently.
+Each DIDO-TE-specific reference has a stable identifier and URI so requirements, architecture sections, definitions, and other records can cite source material consistently.
-DIDO-TE-specific references use identifiers in the form:
+DIDO-TE-specific references use identifiers in the form ''[DTEn]'', where ''n'' is the assigned reference number.
-  * [DTE1]
+Individual reference pages are leaf pages and use namespaces in the form:
-  * [DTE2]
-  * [DTE3]
-The corresponding namespaces use only the stable numeric identifier rather than the document title.
+<code>
+dte-NNN
+</code>
-Examples include:
+The reference identifier remains stable throughout the lifecycle of the reference.
-  * ''dido:03-dido-te:99-annexes:annex-b-references:dte-001:start''
-  * ''dido:03-dido-te:99-annexes:annex-b-references:dte-002:start''
-  * ''dido:03-dido-te:99-annexes:annex-b-references:dte-003:start''
-The descriptive document title appears in the reference-page heading and in the References list.
 ===== References =====
-<todo>Identify and create the DIDO-TE reference pages.</todo>
+  * [[dido:03-dido-te:99-annexes:annex-b-references:dte-001|[DTE1] U.S. Patent Application US20220237111A1]]
+  * [[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]]
+  * [[dido:03-dido-te:99-annexes:annex-b-references:dte-009|[DTE9] Distributed Immutable Data Object Reference Architecture (DIDO-RA)]]
+  * [[dido:03-dido-te:99-annexes:annex-b-references:dte-010|[DTE10] OMG CBDC Working Group Response to the Federal Reserve Discussion Paper]]
 ===== Citation Use =====
-DIDO-TE pages cite a reference by linking the stable identifier.
+Citations use the stable reference identifier followed by the most precise applicable source location.
-For example, a requirement ''Source'' section uses:
+For example:
-[[dido:03-dido-te:99-annexes:annex-b-references:dte-001:start|[DTE1]]], Section 2, Mission Objectives, MO-001.
+<code dokuwiki>
+[[dido:03-dido-te:99-annexes:annex-b-references:dte-002|[DTE2]]], Section 2.1.1.
+</code>
-When a citation refers to a specific location within a source, the citation identifies the applicable section, clause, page, figure, table, or requirement following the reference link.
+A citation to a model identifies the applicable package, diagram, model element, datatype, attribute, association, or other relevant model element.
+For example:
+<code dokuwiki>
+[[dido:03-dido-te:99-annexes:annex-b-references:dte-004|[DTE4]]], model element //Test Plan//.
+</code>
 ===== Contents =====
@@ Line 45: / Line 56: @@
 ===== Notes for Editors =====
-Maintain each reference as a separate linked wiki page with a stable URI.
+Assign each new DIDO-TE-specific reference the next available ''DTE'' identifier.
-Assign each new DIDO-TE-specific reference the next available identifier in the sequence [DTE1], [DTE2], [DTE3], and so forth.
-Use namespaces in the form:
-  * ''dte-001''
-  * ''dte-002''
-  * ''dte-003''
-Do not include the document title in the namespace.
+Maintain each reference as a separate leaf page with a stable URI.
-Use page headings in the form:
+Do not reuse or renumber an assigned reference identifier.
-  * ''====== [DTE1] Document Title ======''
+Use the reference page as the canonical citation target.
-  * ''====== [DTE2] Document Title ======''
-  * ''====== [DTE3] Document Title ======''
-Use the reference page as the canonical citation target rather than repeating the complete citation throughout the DIDO-TE documentation.
+Identify the most precise source location available when deriving a requirement or architectural statement from a reference.
-When a new revision supersedes a referenced document, update the applicable reference page with the new version, revision, date, status, and supersession relationship.
+Preserve historical references when existing requirements, evidence, reports, or externally published documents cite an earlier revision.
-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 renumber or rename reference pages after external citation unless a redirect or move plan is in place.
+Do not rename a reference page after external citation unless a redirect or move plan is in place.
 ----