doc: post-release doc changes 2.9.0

b-gent · rlubos · commit 3665a25025dc · 2024-12-20T13:51:48.000+01:00
Standard revert of release doc updates.

Signed-off-by: Bartosz Gentkowski &lt;bartosz.gentkowski@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.0 <ug_matter_overview_dev_model_support>` | 1.4.0.0                |
+   | v2.9.99 (latest)         | :ref:`1.4.0 <ug_matter_overview_dev_model_support>` | 1.4.0.0                |
+   +--------------------------+                                                     |                        |
+   | |release|                |                                                     |                        |
    +--------------------------+                                                     |                        |
    | v2.9.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_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-rc1.rst b/doc/nrf/releases_and_maturity/migration/migration_guide_2.9.0-nrf54h20-rc1.rst
@@ -1,5 +1,3 @@
-:orphan:
-
 .. _migration_2.9.0-nrf54h20-rc1:
 
 Migration guide for |NCS| v2.9.0-nRF54H20-rc1
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
@@ -0,0 +1,60 @@
+.. _migration_3.0:
+
+Migration guide for |NCS| v3.0.0 (Working draft)
+################################################
+
+.. contents::
+   :local:
+   :depth: 3
+
+This document describes the changes required or recommended when migrating your application from |NCS| v2.9.0 to |NCS| v3.0.0.
+
+.. HOWTO
+   Add changes in the following format:
+   Component (for example, application, sample or libraries)
+   *********************************************************
+   .. toggle::
+      * Change1 and description
+      * Change2 and description
+
+.. _migration_3.0_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.0_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,19 +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 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 customer sampling releases:
-
-* `Migration guide for nRF Connect SDK v2.9.0-nRF54H20-rc1`_
-* `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-2.9.0-nrf54h20-rc1
    releases/release-notes-2.9.0
    releases/release-notes-2.8.0
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,5 +1,3 @@
-:orphan:
-
 .. _ncs_release_notes_changelog:
 
 Changelog for |NCS| v2.9.99
diff --git a/doc/versions.json b/doc/versions.json
@@ -1,4 +1,5 @@
 [
+    "2.9.99",
     "2.9.0-nRF54H20-rc1",
     "2.9.0",
     "2.8.0",

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`	`.. _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`
Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,3 @@`
`1`		`-:orphan:`
`2`		`-`
`3`	`1`	`.. _migration_2.8:`
`4`	`2`
`5`	`3`	`Migration guide for \|NCS\| v2.8.0`
Original file line number	Diff line number	Diff line change
`@@ -1,5 +1,3 @@`
`1`		`-:orphan:`
`2`		`-`
`3`	`1`	`.. _migration_2.9.0-nrf54h20-rc1:`
`4`	`2`
`5`	`3`	`Migration guide for \|NCS\| v2.9.0-nRF54H20-rc1`