doc: Restructure release and migration notes

trantanen · trantanen · commit d7671be1e4ba · 2026-03-26T10:34:12.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,17 @@
+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
