| Both sides previous revision Previous revision | |
| public:99_annexes:annex-b-terms-and-definitions:v:version [2026/09/12 17:42] – ↷ Page moved from private:99_annexes:annex-b-terms-and-definitions:v:version to public:99_annexes:annex-b-terms-and-definitions:v:version nick_dido | public:99_annexes:annex-b-terms-and-definitions:v:version [2026/09/12 17:43] (current) – ↷ Links adapted because of a move operation nick_dido |
|---|
| ====== Version ====== | ====== Version ====== |
| |
| [[private:99_annexes:annex-b-terms-and-definitions:start|Go up to Terms and Definitions]] | [[public:99_annexes:annex-b-terms-and-definitions:start|Go up to Terms and Definitions]] |
| |
| ===== Discussion ===== | ===== Discussion ===== |
| |
| A Version identifies a distinguishable state of an [[private:99_annexes:annex-b-terms-and-definitions:a:artifact|Artifact]]. | A Version identifies a distinguishable state of an [[public:99_annexes:annex-b-terms-and-definitions:a:artifact|Artifact]]. |
| |
| An Artifact can have multiple Versions when its content, structure, behavior, configuration, interface, dependencies, or other governed characteristics change. | An Artifact can have multiple Versions when its content, structure, behavior, configuration, interface, dependencies, or other governed characteristics change. |
| * Specification | * Specification |
| * Requirement | * Requirement |
| * [[private:99_annexes:annex-b-terms-and-definitions:d:data_object|Data Object]] | * [[public:99_annexes:annex-b-terms-and-definitions:d:data_object|Data Object]] |
| * Data model | * Data model |
| * Schema | * Schema |
| * Software component | * Software component |
| * Executable artifact | * Executable artifact |
| * [[private:99_annexes:annex-b-terms-and-definitions:t:test_object|Test Object]] | * [[public:99_annexes:annex-b-terms-and-definitions:t:test_object|Test Object]] |
| * [[private:99_annexes:annex-b-terms-and-definitions:t:test_definition|Test Definition]] | * [[public:99_annexes:annex-b-terms-and-definitions:t:test_definition|Test Definition]] |
| * [[private:99_annexes:annex-b-terms-and-definitions:t:test_executable|Test Executable]] | * [[public:99_annexes:annex-b-terms-and-definitions:t:test_executable|Test Executable]] |
| * [[private:99_annexes:annex-b-terms-and-definitions:t:test_environment|Test Environment]] | * [[public:99_annexes:annex-b-terms-and-definitions:t:test_environment|Test Environment]] |
| * [[private:99_annexes:annex-b-terms-and-definitions:b:baseline|Baseline]] | * [[public:99_annexes:annex-b-terms-and-definitions:b:baseline|Baseline]] |
| |
| A Version should have a Version Identifier that distinguishes it from other Versions of the same Artifact. | A Version should have a Version Identifier that distinguishes it from other Versions of the same Artifact. |
| * Its applicable dependencies | * Its applicable dependencies |
| * Its content digest | * Its content digest |
| * Its applicable [[private:99_annexes:annex-b-terms-and-definitions:g:governance_policy|Governance Policies]] | * Its applicable [[public:99_annexes:annex-b-terms-and-definitions:g:governance_policy|Governance Policies]] |
| * Its [[private:99_annexes:annex-b-terms-and-definitions:p:provenance|Provenance]] | * Its [[public:99_annexes:annex-b-terms-and-definitions:p:provenance|Provenance]] |
| * Its [[private:99_annexes:annex-b-terms-and-definitions:t:traceability|Traceability]] | * Its [[public:99_annexes:annex-b-terms-and-definitions:t:traceability|Traceability]] |
| |
| The applicable versioning policy determines: | The applicable versioning policy determines: |
| * How compatibility among Versions is represented | * How compatibility among Versions is represented |
| |
| [[private:99_annexes:annex-b-terms-and-definitions:v:version_control|Version Control]] manages distinguishable Versions and the relationships among them. | [[public:99_annexes:annex-b-terms-and-definitions:v:version_control|Version Control]] manages distinguishable Versions and the relationships among them. |
| |
| A [[private:99_annexes:annex-b-terms-and-definitions:v:version_control_system|Version Control System]] provides mechanisms for performing Version Control. | A [[public:99_annexes:annex-b-terms-and-definitions:v:version_control_system|Version Control System]] provides mechanisms for performing Version Control. |
| |
| ===== Definition ===== | ===== Definition ===== |
| |
| //identified state of an [[private:99_annexes:annex-b-terms-and-definitions:a:artifact|Artifact]] distinguished from other states of that Artifact// | //identified state of an [[public:99_annexes:annex-b-terms-and-definitions:a:artifact|Artifact]] distinguished from other states of that Artifact// |
| |
| ===== Source ===== | ===== Source ===== |
| Adapted from: | Adapted from: |
| |
| * [[private:99_annexes:annex-b-terms-and-definitions:v:version_control|Version Control]] | * [[public:99_annexes:annex-b-terms-and-definitions:v:version_control|Version Control]] |
| * [[private:99_annexes:annex-b-terms-and-definitions:v:version_control_system|Version Control System]] | * [[public:99_annexes:annex-b-terms-and-definitions:v:version_control_system|Version Control System]] |
| * DIDO Reference Implementation Conceptual Model | * DIDO Reference Implementation Conceptual Model |
| * DIDO-TE draft Requirements Register | * DIDO-TE draft Requirements Register |
| ===== Note ===== | ===== Note ===== |
| |
| A Version is distinct from [[private:99_annexes:annex-b-terms-and-definitions:v:version_control|Version Control]]: | A Version is distinct from [[public:99_annexes:annex-b-terms-and-definitions:v:version_control|Version Control]]: |
| |
| * A Version identifies a distinguishable state of an Artifact | * A Version identifies a distinguishable state of an Artifact |
| * Version Control is the process for managing distinguishable revisions and the relationships among them | * Version Control is the process for managing distinguishable revisions and the relationships among them |
| |
| A Version is distinct from a [[private:99_annexes:annex-b-terms-and-definitions:v:version_control_system|Version Control System]]: | A Version is distinct from a [[public:99_annexes:annex-b-terms-and-definitions:v:version_control_system|Version Control System]]: |
| |
| * A Version identifies the state being managed | * A Version identifies the state being managed |
| * A Version Control System provides the mechanisms used to manage Versions | * A Version Control System provides the mechanisms used to manage Versions |
| |
| A Version is not necessarily a [[private:99_annexes:annex-b-terms-and-definitions:b:baseline|Baseline]]. A Version becomes part of a Baseline only when the applicable authority selects and governs it as part of that Baseline. | A Version is not necessarily a [[public:99_annexes:annex-b-terms-and-definitions:b:baseline|Baseline]]. A Version becomes part of a Baseline only when the applicable authority selects and governs it as part of that Baseline. |
| |
| A Version is not necessarily: | A Version is not necessarily: |
| A change in storage location, packaging, encoding, or representation does not necessarily create a new Version when the governed content and semantics remain unchanged. The applicable versioning policy determines whether such a change requires a new Version. | A change in storage location, packaging, encoding, or representation does not necessarily create a new Version when the governed content and semantics remain unchanged. The applicable versioning policy determines whether such a change requires a new Version. |
| |
| A reproducible [[private:99_annexes:annex-b-terms-and-definitions:t:test_run|Test Run]] should identify the exact Versions of the applicable Test Objects, Test Executables, Test Environments, configurations, policies, dependencies, and other governed Artifacts. | A reproducible [[public:99_annexes:annex-b-terms-and-definitions:t:test_run|Test Run]] should identify the exact Versions of the applicable Test Objects, Test Executables, Test Environments, configurations, policies, dependencies, and other governed Artifacts. |
| |
| ===== Example ===== | ===== Example ===== |
| |
| A [[private:99_annexes:annex-b-terms-and-definitions:t:test_executable|Test Executable]] has the Version Identifier ''2.3.0''. | A [[public:99_annexes:annex-b-terms-and-definitions:t:test_executable|Test Executable]] has the Version Identifier ''2.3.0''. |
| |
| That Version identifies: | That Version identifies: |
| * The execution requirements | * The execution requirements |
| * The executable artifact digest | * The executable artifact digest |
| * The applicable [[private:99_annexes:annex-b-terms-and-definitions:t:test_environment|Test Environments]] | * The applicable [[public:99_annexes:annex-b-terms-and-definitions:t:test_environment|Test Environments]] |
| |
| A later change to the executable instructions creates Version ''2.3.1'' under the applicable versioning policy. | A later change to the executable instructions creates Version ''2.3.1'' under the applicable versioning policy. |
| |
| A [[private:99_annexes:annex-b-terms-and-definitions:t:test_run|Test Run]] identifies Version ''2.3.0'' and its executable artifact digest. This information distinguishes the Test Executable used during the Test Run from Version ''2.3.1'' and supports [[private:99_annexes:annex-b-terms-and-definitions:p:provenance|Provenance]], [[private:99_annexes:annex-b-terms-and-definitions:t:traceability|Traceability]], and reproducibility. | A [[public:99_annexes:annex-b-terms-and-definitions:t:test_run|Test Run]] identifies Version ''2.3.0'' and its executable artifact digest. This information distinguishes the Test Executable used during the Test Run from Version ''2.3.1'' and supports [[public:99_annexes:annex-b-terms-and-definitions:p:provenance|Provenance]], [[public:99_annexes:annex-b-terms-and-definitions:t:traceability|Traceability]], and reproducibility. |
| |
| ---- | ---- |