Differences

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

Link to this comparison view

Both sides previous revision Previous revision
Next revision
Previous revision
public:99_annexes:annex-b-terms-and-definitions:r:revision [2026/09/12 17:42] – removed - external edit (Unknown date) 127.0.0.1public:99_annexes:annex-b-terms-and-definitions:r:revision [2026/09/12 17:43] (current) – ↷ Links adapted because of a move operation nick_dido
Line 1: Line 1:
 +====== Revision ======
  
 +[[public:99_annexes:annex-b-terms-and-definitions:start|Go to Terms and Definitions]]
 +
 +===== Discussion =====
 +
 +A Revision is an identifiable state of an [[public:99_annexes:annex-b-terms-and-definitions:a:artifact|Artifact]] that results from one or more changes.
 +
 +A Revision allows an actor or process to distinguish a particular Artifact state from earlier or later states of the same Artifact.
 +
 +A Revision may apply to:
 +
 +  * Source code
 +  * Documentation
 +  * Models
 +  * Schemas
 +  * Policies
 +  * [[public:99_annexes:annex-b-terms-and-definitions:i:infrastructure_configuration|Infrastructure Configurations]]
 +  * [[public:99_annexes:annex-b-terms-and-definitions:i:infrastructure_blueprint|Infrastructure Blueprints]]
 +  * [[public:99_annexes:annex-b-terms-and-definitions:b:baseline|Baselines]]
 +  * [[public:99_annexes:annex-b-terms-and-definitions:m:machine_image|Machine Images]]
 +  * Build specifications
 +  * Deployment specifications
 +
 +A Revision may include or reference:
 +
 +  * A revision identifier
 +  * The Artifact content associated with the Revision
 +  * The preceding Revision
 +  * The change author
 +  * The change timestamp
 +  * A description of the change
 +  * The applicable approval or release state
 +
 +The applicable requirements determine which information must accompany a Revision.
 +
 +A Revision differs from a version:
 +
 +  * A Revision identifies a distinguishable Artifact state produced through change
 +  * A version may identify a Revision selected, labeled, packaged, or released for a defined purpose
 +
 +A project may use the terms interchangeably when its governing conventions explicitly define them that way.
 +
 +===== Definition =====
 +
 +//identifiable state of an artifact resulting from one or more changes//
 +
 +===== Source =====
 +
 +Dido Solutions, Inc. and Jackrabbit Consulting, Inc.
 +
 +===== Note =====
 +
 +Creation of a Revision does not by itself establish that the Revision is:
 +
 +  * Approved
 +  * Released
 +  * Deployed
 +  * Authoritative
 +  * Compliant
 +  * Suitable for a specified purpose
 +
 +Separate requirements or governance decisions establish those characteristics.
 +
 +A [[public:99_annexes:annex-b-terms-and-definitions:v:version_control_system|Version Control System]] may assign and manage Revision identifiers.
 +
 +===== Example =====
 +
 +A change to an Infrastructure Configuration produces a new Revision with an identifier that distinguishes the changed configuration from its preceding state.
 +
 +----
 +
 +<WRAP centeralign>
 +© 2026 Dido Solutions, Inc. and Jackrabbit Consulting, Inc.
 +</WRAP>