diff --git a/docs/changes.rst b/docs/changes.rst
index 0d0f647de..766d76562 100644
--- a/docs/changes.rst
+++ b/docs/changes.rst
@@ -7,17 +7,13 @@ This section provides information about security and corruption issues.
 
 (nothing to see here yet)
 
-.. _changelog:
+.. _upgradenotes2:
 
-Change Log 2.x
-==============
+Upgrade Notes
+=============
 
-Version 2.0.0b6 (2023-06-11)
-----------------------------
-
-Please note:
-
-This is a beta release, only for testing - do not use for production repos.
+borg 1.2.x to borg 2.0
+----------------------
 
 Compatibility notes:
 
@@ -113,6 +109,22 @@ Compatibility notes:
   fail now that somehow "worked" before (but maybe didn't work as intended due to
   the contradicting options).
 
+
+.. _changelog:
+
+Change Log 2.x
+==============
+
+Version 2.0.0b6 (2023-06-11)
+----------------------------
+
+Please note:
+
+This is a beta release, only for testing - do not use for production repos.
+
+For upgrade and compatibility hints, please also read the section "Upgrade Notes"
+above.
+
 New features:
 
 - diff: include changes in ctime and mtime, #7248