Migration guides
One page per release that changed an SDK's public API — what breaks and what to call instead.
A release that removes or reshapes public API gets a page here, built from the same entries as its changelog section. Each page lists that release's breaking changes with the replacement to adopt — as a code comparison where the calling pattern changed, as a sentence where a name moved. Within the range these guides cover, a release without a page changed nothing you have to touch.
Versions are per-SDK: each package releases on its own number, and each page
covers exactly one release of one SDK. Coming from more than one version
back, apply the pages between your version and the target in order, oldest
first — each page assumes only the release directly before it. Each SDK's
coverage reaches back to its earliest page here; for the stretch before
that, follow the Breaking sections in its changelog.
The pages are written for mechanical application — follow one top-level item at a time, and use the non-breaking additions in the changelog only when a replacement mentions them.