---
id: GOV_NEW_SCHEMA_EVOLUTION
type: decision
status: accepted
tier: T2
title: schema-evolution (current)
description: Current schema-evolution governance.
applies_when:
  - "avro schema"
  - "backward compatible"
  - "schema registry"
  - "field deprecation"
supersedes: GOV_OLD_SCHEMA_EVOLUTION
---

# schema-evolution (current)

This document records the current governance decision for the schema-evolution area. It states the recommended approach, the rationale behind it, and how to request an exception.

## Decision

- Adopt the documented pattern for this area.
- Prefer the recommended approach over ad-hoc alternatives.
- Record any deviation in the project decision record.
- Consult this page before related work begins.
