# Migration Guides

This page collects migration guidance for breaking Askable releases.

## Current policy

- **Patch/minor releases** update the live docs only.
- **Breaking/major releases** preserve the previous major docs under a versioned URL.
- The latest stable docs remain available at `/docs/`.

## Available migrations

There are no published major-version migrations yet.

When Askable ships a breaking release, add:

- a release summary
- key API/behavior changes
- upgrade steps
- before/after examples
- links to the archived docs for the previous major
