# Migrations

> The hand-migration guides between text-to-cad releases, for a project or a computer set up on an earlier one.

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](https://www.texttocad.dev/docs/install#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.

| From | To | Guide |
| --- | --- | --- |
| 0.10 | 0.11 | [Migrating from 0.10 to 0.11](https://www.texttocad.dev/docs/migrations/0.10-to-0.11) |
| 0.8 | 0.10 | [Migrating from 0.8 to 0.10](https://www.texttocad.dev/docs/migrations/0.8-to-0.10) |
| 0.7 | 0.8 | [Migrating from 0.7 to 0.8](https://www.texttocad.dev/docs/migrations/0.7-to-0.8) |
| 0.4 | 0.5 | [Migrating from 0.4 to 0.5](https://www.texttocad.dev/docs/migrations/0.4-to-0.5) |

One guide follows a dependency instead of a release: [moving to OpenCASCADE 8](https://www.texttocad.dev/docs/migrations/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`](https://github.com/earthtojake/text-to-cad/tree/main/docs/migrations), and are shown here as they are written there.

