Revision

Go to Terms and Definitions

A Revision is an identifiable state of an 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
• Infrastructure Configurations
• Infrastructure Blueprints
• Baselines
• 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.

identifiable state of an artifact resulting from one or more changes

Dido Solutions, Inc. and Jackrabbit Consulting, Inc.

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 Version Control System may assign and manage Revision identifiers.

A change to an Infrastructure Configuration produces a new Revision with an identifier that distinguishes the changed configuration from its preceding state.