doc: Restructure release and migration notes

trantanen · trantanen · commit b222616b888c · 2026-03-26T15:14:28.000+02:00
Restructuring release notes and migration notes.
Adding placeholder for v2.x.x migration notes.

Signed-off-by: Tommi Rantanen &lt;tommi.rantanen@nordicsemi.no&gt;
diff --git a/doc/index.rst b/doc/index.rst
@@ -16,5 +16,4 @@ It includes host examples in the form of the |SM| AT Client library and the |SM|
    app/at_commands
    uart_configuration
    samples/README
-   migration_notes
-   release_notes
+   releases/releases
diff --git a/doc/releases/migration_notes.rst b/doc/releases/migration_notes.rst
@@ -0,0 +1,11 @@
+Migration notes
+###############
+
+Migration notes for the |SM| to assist user's transition from the previous releases.
+
+.. toctree::
+   :maxdepth: 1
+   :caption: Subpages:
+
+   migration_notes_v2.0.0
+   migration_notes_ncs_slm_v3.1.x
diff --git a/doc/releases/migration_notes_ncs_slm_v3.1.x.rst b/doc/releases/migration_notes_ncs_slm_v3.1.x.rst
@@ -1,7 +1,7 @@
 .. _migration_3.1.x_SM:
 
-Migration notes
-###############
+Migration notes from |NCS| v3.1.x SLM
+#####################################
 
 .. contents::
    :local:
diff --git a/doc/releases/migration_notes_v2.0.0.rst b/doc/releases/migration_notes_v2.0.0.rst
@@ -0,0 +1,18 @@
+Migration notes for |SM| v2.0.0 (working draft)
+###############################################
+
+.. contents::
+   :local:
+   :depth: 3
+
+This document provides guidance for migrating from |SM| v1.x.x to v2.0.0.
+The general principle has been to keep v2.0.0 backwards compatible.
+However, a small number of changes have been introduced to reduce both maintenance and flash usage.
+Some of these modifications might not require any updates on the host side, even if corresponding features are in use.
+
+Required changes
+****************
+
+The following changes are mandatory to make your application work in the same way as in previous releases.
+
+No changes since the latest release.
diff --git a/doc/releases/release_artifacts.rst b/doc/releases/release_artifacts.rst
@@ -1,16 +1,5 @@
-.. _serial_modem_release_notes:
-
-Release notes
-#############
-
-.. contents::
-   :local:
-   :depth: 2
-
-For all the notable changes to the |SM|, see the `release on GitHub <github_release_>`_.
-
 Release artifacts
-*****************
+#################
 
 The |SM| repository contains the following release artifacts:
 
diff --git a/doc/releases/releases.rst b/doc/releases/releases.rst
@@ -0,0 +1,13 @@
+.. _serial_modem_release_notes:
+
+Release notes
+#############
+
+For all the notable changes to the |SM|, see the `releases on GitHub <github_release_>`_.
+
+.. toctree::
+   :maxdepth: 2
+   :caption: Subpages:
+
+   release_artifacts
+   migration_notes
