[PATCH 4/4] Documentation: migration-2025.07.0: add information about slots_locked

[Lars Schmidt]

Signed-off-by: Lars Schmidt <l.schmidt at pengutronix.de>
---
 Documentation/migration-guides/index.rst               | 1 +
 Documentation/migration-guides/migration-2025.07.0.rst | 8 ++++++++
 Documentation/user/bootchooser.rst                     | 3 +++
 3 files changed, 12 insertions(+)
 create mode 100644 Documentation/migration-guides/migration-2025.07.0.rst

diff --git a/Documentation/migration-guides/index.rst b/Documentation/migration-guides/index.rst
index 182654847f..4bba061476 100644
--- a/Documentation/migration-guides/index.rst
+++ b/Documentation/migration-guides/index.rst
@@ -12,3 +12,4 @@ cause build errors are generally out-of-scope for these documents.
 
    migration-2025.05.0
    migration-2025.06.0
+   migration-2025.07.0
\ No newline at end of file
diff --git a/Documentation/migration-guides/migration-2025.07.0.rst b/Documentation/migration-guides/migration-2025.07.0.rst
new file mode 100644
index 0000000000..c18743a633
--- /dev/null
+++ b/Documentation/migration-guides/migration-2025.07.0.rst
@@ -0,0 +1,8 @@
+Release v2025.07.0
+==================
+
+Bootchooser
+-----------
+
+Bootchooser now interprets a top-level ``slots_locked`` variable.
+For more information, see :ref:`slot locking feature <bootchooser,slots_lock>`
diff --git a/Documentation/user/bootchooser.rst b/Documentation/user/bootchooser.rst
index 306443270a..f767dc77e8 100644
--- a/Documentation/user/bootchooser.rst
+++ b/Documentation/user/bootchooser.rst
@@ -77,6 +77,9 @@ no remaining attempts left.
 To prevent ending up in an unbootable system after a number of failed boot
 attempts, there is also a built-in mechanism to reset the counters to their defaults,
 controlled by the ``global.bootchooser.reset_attempts`` variable.
+
+.. _bootchooser,slots_lock:
+
 Alternatively, counting down the remaining attempts can be disabled by
 locking the bootchooser slots.
 This is done by defining a (32-bit) ``slots_locked`` variable in the
-- 
2.39.5