diff --git a/changelog/unreleased/issue-21 b/changelog/unreleased/issue-21
index 0a3040add..b15c51d71 100644
--- a/changelog/unreleased/issue-21
+++ b/changelog/unreleased/issue-21
@@ -13,7 +13,12 @@ The new format version has not received much testing yet. Do not rely on it as
 your only backup copy! Please run `check` in regular intervals to detect any
 problems.
 
-Upgrading in place is not yet supported. As a workaround, first create a new
+To upgrade in place run `migrate upgrade_repo_v2` followed by `prune`. See the
+documentation for more details. The migration checks the repository integrity
+and upgrades the repository format but will not change any data. Afterwards,
+prune will rewrite the metadata to make use of compression.
+
+As an alternative you can use the `copy` command to migrate snapshots: first create a new
 repository using `init --repository-version 2 --copy-chunker-params --repo2 path/to/old/repo`.
 Then use the `copy` command to copy all snapshots to the new repository.