Migrations

Migrations

Most updates need nothing from you: cad installs every new release of its major version by itself, and cad update does it now. A new major version waits for you: run cad update --major (Updating).

A release that breaks something comes with a migration guide. Each guide says what changed and what to change in a project written for the earlier release. Below 1.0, a breaking change bumps the minor version, so the guides are named for the minor versions they move between.

One guide follows a dependency instead of a release: moving to OpenCASCADE 8, for model code that uses build123d methods 0.12 removed or calls the kernel directly.

The guides are files in the repository, under docs/migrations, and are shown here as they are written there.