{
  "code": null,
  "collection": "architecture",
  "href": "https://banes-lab.com/ontology#architecture-versioning",
  "id": "versioning",
  "kind": "mechanism",
  "layer": {
    "href": "https://banes-lab.com/ontology/schema#layer-contracts-core",
    "json": "https://banes-lab.com/json/records/layer/contracts-core",
    "label": "Contracts Core",
    "markdown": "https://banes-lab.com/records/layer/contracts-core.md",
    "ref": "layer:contracts-core"
  },
  "name": "Versioning",
  "ref": "architecture:versioning",
  "relations": [
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-stable-interfaces",
          "json": "https://banes-lab.com/json/records/architecture/stable-interfaces",
          "label": "Stable Interfaces",
          "markdown": "https://banes-lab.com/records/architecture/stable-interfaces.md",
          "ref": "architecture:stable-interfaces"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-compatibility-policy",
          "json": "https://banes-lab.com/json/records/lexicon/compatibility-policy",
          "label": "Compatibility Policy",
          "markdown": "https://banes-lab.com/records/lexicon/compatibility-policy.md",
          "ref": "lexicon:compatibility-policy"
        }
      ],
      "relation": "requires"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-backward-compatibility",
          "json": "https://banes-lab.com/json/records/architecture/backward-compatibility",
          "label": "Backward Compatibility",
          "markdown": "https://banes-lab.com/records/architecture/backward-compatibility.md",
          "ref": "architecture:backward-compatibility"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-governance",
          "json": "https://banes-lab.com/json/records/architecture/governance",
          "label": "Governance",
          "markdown": "https://banes-lab.com/records/architecture/governance.md",
          "ref": "architecture:governance"
        }
      ],
      "relation": "reinforces"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-controlled-evolution",
          "json": "https://banes-lab.com/json/records/lexicon/controlled-evolution",
          "label": "Controlled Evolution",
          "markdown": "https://banes-lab.com/records/lexicon/controlled-evolution.md",
          "ref": "lexicon:controlled-evolution"
        }
      ],
      "relation": "enables"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-silent-breaking-changes",
          "json": "https://banes-lab.com/json/records/lexicon/silent-breaking-changes",
          "label": "Silent Breaking Changes",
          "markdown": "https://banes-lab.com/records/lexicon/silent-breaking-changes.md",
          "ref": "lexicon:silent-breaking-changes"
        }
      ],
      "relation": "conflicts-with"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-version-sprawl",
          "json": "https://banes-lab.com/json/records/lexicon/version-sprawl",
          "label": "Version Sprawl",
          "markdown": "https://banes-lab.com/records/lexicon/version-sprawl.md",
          "ref": "lexicon:version-sprawl"
        }
      ],
      "relation": "tensions-with"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/schema#tension-version-sprawl-versioning",
          "json": "https://banes-lab.com/json/records/tension/version-sprawl-versioning",
          "label": "Versioning / Version Sprawl",
          "markdown": "https://banes-lab.com/records/tension/version-sprawl-versioning.md",
          "ref": "tension:version-sprawl-versioning"
        }
      ],
      "relation": "tensions"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/algorithms#algorithms-no-breaking-change",
          "json": "https://banes-lab.com/json/records/algorithms/no-breaking-change",
          "label": "Versioned Evolution Over Breaking Change",
          "markdown": "https://banes-lab.com/records/algorithms/no-breaking-change.md",
          "ref": "algorithms:no-breaking-change"
        },
        {
          "href": "https://banes-lab.com/ontology/algorithms#algorithms-living-profile-kernel",
          "json": "https://banes-lab.com/json/records/algorithms/living-profile-kernel",
          "label": "Living Profile Kernel",
          "markdown": "https://banes-lab.com/records/algorithms/living-profile-kernel.md",
          "ref": "algorithms:living-profile-kernel"
        }
      ],
      "relation": "contracts"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-unversioned-breaking-change",
          "json": "https://banes-lab.com/json/records/architecture/unversioned-breaking-change",
          "label": "Unversioned Breaking Change",
          "markdown": "https://banes-lab.com/records/architecture/unversioned-breaking-change.md",
          "ref": "architecture:unversioned-breaking-change"
        }
      ],
      "relation": "violated-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology/schema#vocabulary-severity-mandatory",
          "json": "https://banes-lab.com/json/records/vocabulary/severity-mandatory",
          "label": "mandatory",
          "markdown": "https://banes-lab.com/records/vocabulary/severity-mandatory.md",
          "ref": "vocabulary:severity-mandatory"
        }
      ],
      "relation": "severity"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-category-contracts-interfaces-compatibility",
          "json": "https://banes-lab.com/json/records/architecture-category/contracts-interfaces-compatibility",
          "label": "Contracts / Interfaces / Compatibility",
          "markdown": "https://banes-lab.com/records/architecture-category/contracts-interfaces-compatibility.md",
          "ref": "architecture-category:contracts-interfaces-compatibility"
        }
      ],
      "relation": "category"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-schema-drift",
          "json": "https://banes-lab.com/json/records/architecture/schema-drift",
          "label": "Schema Drift",
          "markdown": "https://banes-lab.com/records/architecture/schema-drift.md",
          "ref": "architecture:schema-drift"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-cyclic-deployment-dependency",
          "json": "https://banes-lab.com/json/records/architecture/cyclic-deployment-dependency",
          "label": "Cyclic Deployment Dependency",
          "markdown": "https://banes-lab.com/records/architecture/cyclic-deployment-dependency.md",
          "ref": "architecture:cyclic-deployment-dependency"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-cache-poisoning-by-design",
          "json": "https://banes-lab.com/json/records/architecture/cache-poisoning-by-design",
          "label": "Cache Poisoning by Design",
          "markdown": "https://banes-lab.com/records/architecture/cache-poisoning-by-design.md",
          "ref": "architecture:cache-poisoning-by-design"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-api-contract",
          "json": "https://banes-lab.com/json/records/architecture/api-contract",
          "label": "API Contract",
          "markdown": "https://banes-lab.com/records/architecture/api-contract.md",
          "ref": "architecture:api-contract"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-service-contract",
          "json": "https://banes-lab.com/json/records/architecture/service-contract",
          "label": "Service Contract",
          "markdown": "https://banes-lab.com/records/architecture/service-contract.md",
          "ref": "architecture:service-contract"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-canonical-schema",
          "json": "https://banes-lab.com/json/records/architecture/canonical-schema",
          "label": "Canonical Schema",
          "markdown": "https://banes-lab.com/records/architecture/canonical-schema.md",
          "ref": "architecture:canonical-schema"
        }
      ],
      "relation": "refactors"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/ontology#architecture-api-contract",
          "json": "https://banes-lab.com/json/records/architecture/api-contract",
          "label": "API Contract",
          "markdown": "https://banes-lab.com/records/architecture/api-contract.md",
          "ref": "architecture:api-contract"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-protocol-compatibility",
          "json": "https://banes-lab.com/json/records/architecture/protocol-compatibility",
          "label": "Protocol Compatibility",
          "markdown": "https://banes-lab.com/records/architecture/protocol-compatibility.md",
          "ref": "architecture:protocol-compatibility"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-integration-events",
          "json": "https://banes-lab.com/json/records/architecture/integration-events",
          "label": "Integration Events",
          "markdown": "https://banes-lab.com/records/architecture/integration-events.md",
          "ref": "architecture:integration-events"
        }
      ],
      "relation": "required-by"
    },
    {
      "links": [
        {
          "href": "https://banes-lab.com/software-architecture/decay#seven-controls-seven-classes",
          "json": "https://banes-lab.com/json/software-architecture/decay/seven-controls-seven-classes",
          "label": "Seven controls, seven classes",
          "markdown": "https://banes-lab.com/software-architecture/decay/seven-controls-seven-classes.md",
          "ref": "chapter:/software-architecture/decay#seven-controls-seven-classes"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-anti-patterns",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-anti-patterns",
          "label": "Anti-patterns",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-anti-patterns.md",
          "ref": "chapter:/ontology#architecture-category-anti-patterns"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-contracts-interfaces-compatibility",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-contracts-interfaces-compatibility",
          "label": "Contracts / Interfaces / Compatibility",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-contracts-interfaces-compatibility.md",
          "ref": "chapter:/ontology#architecture-category-contracts-interfaces-compatibility"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-event-messaging-asynchronous-architecture",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-event-messaging-asynchronous-architecture",
          "label": "Event / Messaging / Asynchronous Architecture",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-event-messaging-asynchronous-architecture.md",
          "ref": "chapter:/ontology#architecture-category-event-messaging-asynchronous-architecture"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-schema-canonical-data-semantics",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-schema-canonical-data-semantics",
          "label": "Schema / Canonical Data / Semantics",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-schema-canonical-data-semantics.md",
          "ref": "chapter:/ontology#architecture-category-schema-canonical-data-semantics"
        },
        {
          "href": "https://banes-lab.com/ontology#architecture-category-security-privacy-compliance-governance",
          "json": "https://banes-lab.com/json/ontology/principles/architecture-category-security-privacy-compliance-governance",
          "label": "Security / Privacy / Compliance / Governance",
          "markdown": "https://banes-lab.com/ontology/principles/architecture-category-security-privacy-compliance-governance.md",
          "ref": "chapter:/ontology#architecture-category-security-privacy-compliance-governance"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-category-contracts-interfaces-compatibility",
          "json": "https://banes-lab.com/json/ontology/lexicon/lexicon-category-contracts-interfaces-compatibility",
          "label": "Contracts / Interfaces / Compatibility",
          "markdown": "https://banes-lab.com/ontology/lexicon/lexicon-category-contracts-interfaces-compatibility.md",
          "ref": "chapter:/ontology/lexicon#lexicon-category-contracts-interfaces-compatibility"
        },
        {
          "href": "https://banes-lab.com/ontology/lexicon#lexicon-category-core-vocabulary",
          "json": "https://banes-lab.com/json/ontology/lexicon/lexicon-category-core-vocabulary",
          "label": "Core Vocabulary",
          "markdown": "https://banes-lab.com/ontology/lexicon/lexicon-category-core-vocabulary.md",
          "ref": "chapter:/ontology/lexicon#lexicon-category-core-vocabulary"
        },
        {
          "href": "https://banes-lab.com/ontology/algorithms#algorithms-domain-architectural-rules",
          "json": "https://banes-lab.com/json/ontology/algorithms/algorithms-domain-architectural-rules",
          "label": "Architectural Rules",
          "markdown": "https://banes-lab.com/ontology/algorithms/algorithms-domain-architectural-rules.md",
          "ref": "chapter:/ontology/algorithms#algorithms-domain-architectural-rules"
        },
        {
          "href": "https://banes-lab.com/ontology/algorithms#algorithms-domain-living-profile",
          "json": "https://banes-lab.com/json/ontology/algorithms/algorithms-domain-living-profile",
          "label": "Living profile",
          "markdown": "https://banes-lab.com/ontology/algorithms/algorithms-domain-living-profile.md",
          "ref": "chapter:/ontology/algorithms#algorithms-domain-living-profile"
        },
        {
          "href": "https://banes-lab.com/ontology/schema#the-vocabulary-severity",
          "json": "https://banes-lab.com/json/ontology/schema/the-vocabulary-severity",
          "label": "Severity levels",
          "markdown": "https://banes-lab.com/ontology/schema/the-vocabulary-severity.md",
          "ref": "chapter:/ontology/schema#the-vocabulary-severity"
        },
        {
          "href": "https://banes-lab.com/ontology/schema#the-resolutions",
          "json": "https://banes-lab.com/json/ontology/schema/the-resolutions",
          "label": "The resolutions",
          "markdown": "https://banes-lab.com/ontology/schema/the-resolutions.md",
          "ref": "chapter:/ontology/schema#the-resolutions"
        }
      ],
      "relation": "linked-from"
    }
  ],
  "summary": "A mechanism that labels each release of an interface or schema, so consumers can tell compatible changes from breaking ones.",
  "siblings": {
    "next": {
      "href": "https://banes-lab.com/ontology#architecture-protocol-compatibility",
      "json": "https://banes-lab.com/json/records/architecture/protocol-compatibility",
      "label": "Protocol Compatibility",
      "markdown": "https://banes-lab.com/records/architecture/protocol-compatibility.md",
      "ref": "architecture:protocol-compatibility"
    },
    "previous": {
      "href": "https://banes-lab.com/ontology#architecture-forward-compatibility",
      "json": "https://banes-lab.com/json/records/architecture/forward-compatibility",
      "label": "Forward Compatibility",
      "markdown": "https://banes-lab.com/records/architecture/forward-compatibility.md",
      "ref": "architecture:forward-compatibility"
    }
  },
  "up": {
    "href": null,
    "json": "https://banes-lab.com/json/api/records/architecture",
    "label": "Architecture principles",
    "markdown": "https://banes-lab.com/api/records/architecture.md",
    "ref": "api:records/architecture"
  },
  "aliases": [],
  "exemplar": {
    "after": "queue.publish(\"foo.created.v2\", {\n  schemaVersion: 2,\n  id: foo.id,\n  label: foo.name,\n});",
    "before": "queue.publish(\"foo.created\", { id: foo.id, name: foo.name });",
    "lang": "ts",
    "medium": "code"
  },
  "formedBy": null,
  "scope": [
    "API",
    "schema",
    "package",
    "service"
  ],
  "severity": "mandatory"
}