docs: move upgrade notes to own section, see #7546

borgbackup · Jul 1, 2023 · 6d9e8e5 · 6d9e8e5
1 parent 55af769
commit 6d9e8e5
Showing 1 changed file with 16 additions and 7 deletions.
diff --git a/docs/changes.rst b/docs/changes.rst
@@ -212,15 +212,13 @@ The best check that everything is ok is to run a dry-run extraction::
 
     borg extract -v --dry-run REPO::ARCHIVE
 
-.. _changelog:
-
-Change Log
-==========
+.. _upgradenotes:
 
-Version 1.2.4 (2023-03-24)
---------------------------
+Upgrade Notes
+=============
 
-Upgrade notes:
+borg 1.1.x to 1.2.x
+-------------------
 
 Some things can be recommended for the upgrade process from borg 1.1.x
 (please also read the important compatibility notes below):
@@ -296,6 +294,17 @@ Compatibility notes:
   them to check for >= 128.
 
 
+.. _changelog:
+
+Change Log
+==========
+
+Version 1.2.4 (2023-03-24)
+--------------------------
+
+For upgrade and compatibility hints, please also read the section "Upgrade Notes"
+above.
+
 New features:
 
 - import-tar: add --ignore-zeros to process concatenated tars, #7432.