doc: post-release doc update for 3.1.0

divipillai · carlescufi · commit 404e77d58fa0 · 2025-08-14T10:23:34.000+02:00
Standard post-release changes in documentation.
Changing version to 3.1.99.

Signed-off-by: divya pillai &lt;divya.pillai@nordicsemi.no&gt;
diff --git a/doc/nrf/protocols/matter/index.rst b/doc/nrf/protocols/matter/index.rst
@@ -23,7 +23,9 @@ For a full list of |NCS| and Matter versions, view the following table:
    +--------------------------+-----------------------------------------------------+------------------------+
    | nRF Connect SDK version  | Matter specification version                        | Matter SDK version     |
    +==========================+=====================================================+========================+
-   | |release|                | :ref:`1.4.2 <ug_matter_overview_dev_model_support>` | 1.4.2.0                |
+   | v3.1.99 (latest)         | :ref:`1.4.2 <ug_matter_overview_dev_model_support>` |                        |
+   +--------------------------+                                                     |                        |
+   | |release|                |                                                     | 1.4.2.0                |
    +--------------------------+-----------------------------------------------------+------------------------+
    | v3.0.2                   | :ref:`1.4.1 <ug_matter_overview_dev_model_support>` | 1.4.1.0                |
    +--------------------------+                                                     |                        |
diff --git a/doc/nrf/releases_and_maturity.rst b/doc/nrf/releases_and_maturity.rst
@@ -28,3 +28,4 @@ If an issue is found in a release after it has taken place, those issues are lis
    releases_and_maturity/repository_revisions
    releases_and_maturity/software_maturity
    releases_and_maturity/abi_compatibility
+   releases_and_maturity/known_issues
diff --git a/doc/nrf/releases_and_maturity/known_issues.rst b/doc/nrf/releases_and_maturity/known_issues.rst
@@ -1,5 +1,3 @@
-:orphan:
-
 .. _known_issues:
 
 Known issues
diff --git a/doc/nrf/releases_and_maturity/migration/migration_3.1_54h_suit_ironside.rst b/doc/nrf/releases_and_maturity/migration/migration_3.1_54h_suit_ironside.rst
@@ -1,5 +1,3 @@
-:orphan:
-
 .. _migration_3.1_54h_suit_ironside:
 
 Migration from SUIT to IronSide SE for the nRF54H20 SoC
diff --git a/doc/nrf/releases_and_maturity/migration/migration_bicr_nRF54H20.rst b/doc/nrf/releases_and_maturity/migration/migration_bicr_nRF54H20.rst
@@ -1,5 +1,3 @@
-:orphan:
-
 .. _migration_bicr_nrf54h:
 
 Migrating nRF54H20 SoC BICR from DTS to JSON
diff --git a/doc/nrf/releases_and_maturity/migration/migration_guide_1.x_to_2.x.rst b/doc/nrf/releases_and_maturity/migration/migration_guide_1.x_to_2.x.rst
@@ -1,5 +1,3 @@
-:orphan:
-
 .. _ncs_2.0.0_migration:
 
 Migration notes for |NCS| v2.0.0
diff --git a/doc/nrf/releases_and_maturity/migration/migration_guide_2.4.99-cs3_to_2.6.99-cs2.rst b/doc/nrf/releases_and_maturity/migration/migration_guide_2.4.99-cs3_to_2.6.99-cs2.rst
@@ -1,5 +1,3 @@
-:orphan:
-
 .. _migration_cs3_to_2_6_99_cs2:
 
 Migration notes for |NCS| v2.6.99_cs2 for v2.4.99-cs3 users
diff --git a/doc/nrf/releases_and_maturity/migration/migration_guide_2.5.rst b/doc/nrf/releases_and_maturity/migration/migration_guide_2.5.rst
@@ -1,5 +1,3 @@
-:orphan:
-
 .. _migration_2.5:
 
 Migration guide for |NCS| v2.5.0
diff --git a/doc/nrf/releases_and_maturity/migration/migration_guide_2.6.rst b/doc/nrf/releases_and_maturity/migration/migration_guide_2.6.rst
@@ -1,5 +1,3 @@
-:orphan:
-
 .. _migration_2.6:
 
 Migration guide for |NCS| v2.6.0
diff --git a/doc/nrf/releases_and_maturity/migration/migration_guide_2.7.rst b/doc/nrf/releases_and_maturity/migration/migration_guide_2.7.rst
@@ -1,5 +1,3 @@
-:orphan:
-
 .. _migration_2.7:
 
 Migration guide for |NCS| v2.7.0
diff --git a/doc/nrf/releases_and_maturity/migration/migration_guide_2.8.rst b/doc/nrf/releases_and_maturity/migration/migration_guide_2.8.rst
@@ -1,5 +1,3 @@
-:orphan:
-
 .. _migration_2.8:
 
 Migration guide for |NCS| v2.8.0
diff --git a/doc/nrf/releases_and_maturity/migration/migration_guide_2.9.0-nRF54H20-1.rst b/doc/nrf/releases_and_maturity/migration/migration_guide_2.9.0-nRF54H20-1.rst
@@ -1,5 +1,3 @@
-:orphan:
-
 .. _migration_2.9.0-nRF54H20-1:
 
 Migration guide for |NCS| v2.9.0-nRF54H20-1
diff --git a/doc/nrf/releases_and_maturity/migration/migration_guide_2.9.rst b/doc/nrf/releases_and_maturity/migration/migration_guide_2.9.rst
@@ -1,5 +1,3 @@
-:orphan:
-
 .. _migration_2.9:
 
 Migration guide for |NCS| v2.9.0
diff --git a/doc/nrf/releases_and_maturity/migration/migration_guide_3.0.rst b/doc/nrf/releases_and_maturity/migration/migration_guide_3.0.rst
@@ -1,5 +1,3 @@
-:orphan:
-
 .. _migration_3.0:
 
 Migration guide for |NCS| v3.0.0
diff --git a/doc/nrf/releases_and_maturity/migration/migration_guide_3.1.rst b/doc/nrf/releases_and_maturity/migration/migration_guide_3.1.rst
@@ -1,5 +1,3 @@
-:orphan:
-
 .. _migration_3.1:
 
 Migration guide for |NCS| v3.1.0
diff --git a/doc/nrf/releases_and_maturity/migration/migration_guide_3.2.rst b/doc/nrf/releases_and_maturity/migration/migration_guide_3.2.rst
@@ -0,0 +1,60 @@
+.. _migration_3.2:
+
+Migration guide for |NCS| v3.2.0 (Working draft)
+################################################
+
+.. contents::
+   :local:
+   :depth: 3
+
+This document describes the changes required or recommended when migrating your application from |NCS| v3.1.0 to |NCS| v3.2.0.
+
+.. HOWTO
+   Add changes in the following format:
+   Component (for example, application, sample or libraries)
+   *********************************************************
+   .. toggle::
+      * Change1 and description
+      * Change2 and description
+
+.. _migration_3.2_required:
+
+Required changes
+****************
+
+The following changes are mandatory to make your application work in the same way as in previous releases.
+
+Samples and applications
+========================
+
+This section describes the changes related to samples and applications.
+
+|no_changes_yet_note|
+
+Libraries
+=========
+
+This section describes the changes related to libraries.
+
+|no_changes_yet_note|
+
+.. _migration_3.2_recommended:
+
+Recommended changes
+*******************
+
+The following changes are recommended for your application to work optimally after the migration.
+
+Samples and applications
+========================
+
+This section describes the changes related to samples and applications.
+
+|no_changes_yet_note|
+
+Libraries
+=========
+
+This section describes the changes related to libraries.
+
+|no_changes_yet_note|
diff --git a/doc/nrf/releases_and_maturity/migration/migration_guide_nRF54H20_cs_to_2_7.rst b/doc/nrf/releases_and_maturity/migration/migration_guide_nRF54H20_cs_to_2_7.rst
@@ -1,5 +1,3 @@
-:orphan:
-
 .. _migration_nrf54h20_to_2.7:
 
 Migration notes for |NCS| v2.7.0 and the nRF54H20 DK
diff --git a/doc/nrf/releases_and_maturity/migration/migration_guide_nRF54H20_cs_to_2_7_99-cs1.rst b/doc/nrf/releases_and_maturity/migration/migration_guide_nRF54H20_cs_to_2_7_99-cs1.rst
@@ -1,5 +1,3 @@
-:orphan:
-
 .. _migration_nrf54h20_to_2.7.99-cs1:
 
 Migration notes for |NCS| v2.7.99-cs1 and the nRF54H20 DK
diff --git a/doc/nrf/releases_and_maturity/migration/migration_guide_nRF54H20_cs_to_2_7_99-cs2.rst b/doc/nrf/releases_and_maturity/migration/migration_guide_nRF54H20_cs_to_2_7_99-cs2.rst
@@ -1,5 +1,3 @@
-:orphan:
-
 .. _migration_nrf54h20_to_2.7.99-cs2:
 
 Migration notes for |NCS| v2.7.99-cs2 and the nRF54H20 DK
diff --git a/doc/nrf/releases_and_maturity/migration/migration_hwmv2.rst b/doc/nrf/releases_and_maturity/migration/migration_hwmv2.rst
@@ -1,5 +1,3 @@
-:orphan:
-
 .. _hwmv1_to_v2_migration:
 
 Migrating to the current hardware model
diff --git a/doc/nrf/releases_and_maturity/migration/migration_sysbuild.rst b/doc/nrf/releases_and_maturity/migration/migration_sysbuild.rst
@@ -1,5 +1,3 @@
-:orphan:
-
 .. _child_parent_to_sysbuild_migration:
 
 Migrating from multi-image builds to sysbuild
diff --git a/doc/nrf/releases_and_maturity/migration_guides.rst b/doc/nrf/releases_and_maturity/migration_guides.rst
@@ -9,23 +9,10 @@ Migration guides are also provided for major functionality updates.
 .. note::
     |migration_contact_devzone|
 
-* `Migrating from multi-image builds to sysbuild`_
-* `Migrating to the current hardware model`_
-* `Migration guide for nRF Connect SDK v3.1.0`_
-* `Migration guide for nRF Connect SDK v3.0.0`_
-* `Migration guide for nRF Connect SDK v2.9.0`_
-* `Migration guide for nRF Connect SDK v2.8.0`_
-* `Migration guide for nRF Connect SDK v2.7.0`_
-* `Migration guide for nRF Connect SDK v2.6.0`_
-* `Migration guide for nRF Connect SDK v2.5.0`_
-* `Migration guide for nRF Connect SDK v2.0.0`_
+.. toctree::
+   :maxdepth: 1
+   :glob:
+   :reversed:
+   :caption: Subpages:
 
-For nRF54H20-exclusive releases:
-
-* `Migration from SUIT to IronSide SE for the nRF54H20 SoC`_
-* `Migrating nRF54H20 SoC BICR from DTS to JSON`_
-* `Migration guide for nRF Connect SDK v2.9.0-nRF54H20-1`_
-* `Migration notes for nRF Connect SDK v2.7.99-cs2 and the nRF54H20 DK`_
-* `Migration notes for nRF Connect SDK v2.7.99-cs1 and the nRF54H20 DK`_
-* `Migration notes for nRF Connect SDK v2.7.0 for nRF54H20 DK users`_
-* `Migration guide for nRF Connect SDK v2.6.99_cs2 for v2.4.99-cs3 users`_
+   migration/*
diff --git a/doc/nrf/releases_and_maturity/release_notes.rst b/doc/nrf/releases_and_maturity/release_notes.rst
@@ -10,15 +10,17 @@ This page is included only in the latest documentation, because it might contain
 
 .. note::
    A "99" at the end of the version number of this documentation indicates continuous updates on the main branch since the previous major.minor release.
-   When looking at this latest documentation, be aware of the following aspect:
+   When looking at this latest documentation, be aware of the following aspects:
 
+   * Changes between releases are tracked on the :ref:`ncs_release_notes_changelog` page, but the main branch might contain additional changes that are not listed on that page.
    * The release note pages that are available in the latest documentation might differ slightly from the release notes that were included in the respective |NCS| release at its release date.
      Therefore, to see the official version of the release notes for a specific |NCS| release, switch to the documentation for the corresponding |NCS| version using the selector in the upper left corner.
 
 .. toctree::
    :maxdepth: 1
    :caption: Subpages:
 
+   releases/release-notes-changelog
    releases/release-notes-3.1.0
    releases/release-notes-3.1.0-preview3
    releases/release-notes-3.1.0-preview2
diff --git a/doc/nrf/releases_and_maturity/releases/release-notes-changelog.rst b/doc/nrf/releases_and_maturity/releases/release-notes-changelog.rst
@@ -1,8 +1,6 @@
-:orphan:
-
 .. _ncs_release_notes_changelog:
 
-Changelog for |NCS| v3.0.99
+Changelog for |NCS| v3.1.99
 ###########################
 
 .. contents::
@@ -25,7 +23,7 @@ Known issues
 ************
 
 Known issues are only tracked for the latest official release.
-See `known issues for nRF Connect SDK v3.0.0`_ for the list of issues valid for the latest release.
+See `known issues for nRF Connect SDK v3.1.0`_ for the list of issues valid for the latest release.
 
 Changelog
 *********
@@ -530,21 +528,21 @@ Zephyr
 
 .. NOTE TO MAINTAINERS: All the Zephyr commits in the below git commands must be handled specially after each upmerge and each nRF Connect SDK release.
 
-The Zephyr fork in |NCS| (``sdk-zephyr``) contains all commits from the upstream Zephyr repository up to and including ``9a6f116a6aa9b70b517a420247cd8d33bbbbaaa3``, with some |NCS| specific additions.
+The Zephyr fork in |NCS| (``sdk-zephyr``) contains all commits from the upstream Zephyr repository up to and including ``0fe59bf1e4b96122c3467295b09a034e399c5ee6``, with some |NCS| specific additions.
 
-For the list of upstream Zephyr commits (not including cherry-picked commits) incorporated into nRF Connect SDK since the most recent release, run the following command from the :file:`ncs/zephyr` repository (after running ``west update``):
+For the list of upstream Zephyr commits (not including cherry-picked commits) incorporated into |NCS| since the most recent release, run the following command from the :file:`ncs/zephyr` repository (after running ``west update``):
 
 .. code-block:: none
 
-   git log --oneline 9a6f116a6a ^fdeb735017
+   git log --oneline 0fe59bf1e4 ^fdeb735017
 
 For the list of |NCS| specific commits, including commits cherry-picked from upstream, run:
 
 .. code-block:: none
 
-   git log --oneline manifest-rev ^9a6f116a6a
+   git log --oneline manifest-rev ^0fe59bf1e4
 
-The current |NCS| main branch is based on revision ``9a6f116a6a`` of Zephyr.
+The current |NCS| main branch is based on revision ``0fe59bf1e4`` of Zephyr.
 
 .. note::
    For possible breaking changes and changes between the latest Zephyr release and the current Zephyr version, refer to the :ref:`Zephyr release notes <zephyr_release_notes>`.
@@ -564,11 +562,6 @@ Trusted Firmware-M
 
 |no_changes_yet_note|
 
-cJSON
-=====
-
-|no_changes_yet_note|
-
 Documentation
 =============
 
diff --git a/doc/versions.json b/doc/versions.json
@@ -1,4 +1,5 @@
 [
+    "3.1.99",
     "3.1.0",
     "3.1.0-preview3",
     "3.1.0-preview2",

Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,3 @@`
`1`		`-:orphan:`
`2`		`-`
`3`	`1`	`.. _known_issues:`
`4`	`2`
`5`	`3`	`Known issues`
Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,3 @@`
`1`		`-:orphan:`
`2`		`-`
`3`	`1`	`.. _migration_3.1_54h_suit_ironside:`
`4`	`2`
`5`	`3`	`Migration from SUIT to IronSide SE for the nRF54H20 SoC`
Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,3 @@`
`1`		`-:orphan:`
`2`		`-`
`3`	`1`	`.. _migration_bicr_nrf54h:`
`4`	`2`
`5`	`3`	`Migrating nRF54H20 SoC BICR from DTS to JSON`
Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,3 @@`
`1`		`-:orphan:`
`2`		`-`
`3`	`1`	`.. _ncs_2.0.0_migration:`
`4`	`2`
`5`	`3`	`Migration notes for \|NCS\| v2.0.0`
Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,3 @@`
`1`		`-:orphan:`
`2`		`-`
`3`	`1`	`.. _migration_cs3_to_2_6_99_cs2:`
`4`	`2`
`5`	`3`	`Migration notes for \|NCS\| v2.6.99_cs2 for v2.4.99-cs3 users`
Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,3 @@`
`1`		`-:orphan:`
`2`		`-`
`3`	`1`	`.. _migration_2.5:`
`4`	`2`
`5`	`3`	`Migration guide for \|NCS\| v2.5.0`
Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,3 @@`
`1`		`-:orphan:`
`2`		`-`
`3`	`1`	`.. _migration_2.6:`
`4`	`2`
`5`	`3`	`Migration guide for \|NCS\| v2.6.0`
Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,3 @@`
`1`		`-:orphan:`
`2`		`-`
`3`	`1`	`.. _migration_2.7:`
`4`	`2`
`5`	`3`	`Migration guide for \|NCS\| v2.7.0`