1# Migration Annotations
2
3Add or update one YAML file per v3 module under `migration/annotations/`. Use
4stable API IDs without trailing `#type` or `#value` facets:
5
6```yaml
7effect/Effect#async:
8 replacement: Effect.callback
9 note: Use the callback constructor.
10 example: Effect.callback((resume) => resume(Effect.void))
11```
12
13Every annotation requires `replacement` and `note`; `example` is optional. Use
14`replacement: none` when there is no direct replacement and explain the
15supported migration strategy instead of inventing an equivalent API.