Upgrades and Migrations

Upgrades And Migrations

Authority: Navigation; release notes and schemas are canonical
Applies to: Published Citable releases
Last reviewed: 2026-07-19
Maintainer: @mikeholownych

Before upgrading:

1. Read the exact release notes.
2. Preserve current registries and immutable run packages.
3. Check schema and command compatibility.
4. Upgrade in a branch or isolated environment.
5. Validate registries and run the repository's test/build gates.
6. Record detector, configuration, observation-method, and tool-version changes separately from property changes.

Never infer property regression solely from a result changed by a detector or collector update.