Phase 9 of 9 in the v2 go-live runbook — see #1804 (§10). Pairs with #1803.
Write the v1 → v2 migration guide.
This is the highest-value doc shipped alongside the swap. CLI flags changed substantially, and --config semantics are genuinely different in v2 (read-only session file, with --catalog as the writable one). Without this, the deprecation notice sends people somewhere confusing.
Tasks
Phase 9 of 9 in the v2 go-live runbook — see #1804 (§10). Pairs with #1803.
Write the v1 → v2 migration guide.
This is the highest-value doc shipped alongside the swap. CLI flags changed substantially, and
--configsemantics are genuinely different in v2 (read-only session file, with--catalogas the writable one). Without this, the deprecation notice sends people somewhere confusing.Tasks
--configvs--catalogsemantics, with before/after examples.inspector-client/inspector-server/inspector-clisub-packages (v2 is a single tarball).