akm docs

Release-notes corpus for akm help migrate

This directory holds one .md file per release. Each file is the short, focused migration note that akm help migrate <version> prints to the terminal. The longform cross-release guides (e.g. v0.5-to-v0.6.md) live one level up in docs/migration/.

Available notes

Adding notes for a new release

  1. Create <version>.md in this directory (e.g. 0.7.0.md).
  2. Start the file with # akm v<version> migration notes, then list the automatic migrations, manual actions, publisher changes, and any longform guide links the terminal user may need.
  3. The file ships with the published package via package.json → files[] and is resolved at runtime from either src/ or dist/, so no code change is required.
  4. Link to the longform guide in the last paragraph if one exists.

Keep each note self-contained: it should tell a user everything they need to upgrade without requiring them to open a browser (the longform guide link is the last resort, not the first).