| 1 | # Migration annotations |
| 2 | |
| 3 | Add one YAML file per v3 module. Each file maps stable API ids (without the |
| 4 | snapshot's trailing `#type` or `#value` facet) to migration guidance: |
| 5 | |
| 6 | ```yaml |
| 7 | effect/Effect#async: |
| 8 | replacement: Effect.callback |
| 9 | note: Use the callback constructor. |
| 10 | example: Effect.callback((resume) => resume(Effect.void)) |
| 11 | ``` |
| 12 | |
| 13 | Run `pnpm api-diff --check` to list missing ids and |
| 14 | `pnpm api-diff --write-doc migration/v3-to-v4.md` to regenerate the reference. |