Merge pull request #2513 from stewart-ibm/random-docs-improvements

Random docs improvements

5 files changed, 79 insertions, 46 deletions

diff --git a/doc/release-notes/index.rst b/doc/release-notes/index.rst
index 3f8345b3..dd4bfb98 100644
--- a/doc/release-notes/index.rst
+++ b/doc/release-notes/index.rst
@@ -3,6 +3,9 @@
 op-build Release Notes
 ======================
 
+v1.21
+-----
+
 .. toctree::
    :maxdepth: 1
 
@@ -11,8 +14,22 @@ op-build Release Notes
    v1.21
    v1.21.1
    v1.21.2
+
+v1.22
+-----
+
+.. toctree::
+   :maxdepth: 1
+
    v1.22-rc1
    v1.22
+
+v2.0
+----
+
+.. toctree::
+   :maxdepth: 1
+
    v2.0-rc1
    v2.0
    v2.0.1
@@ -26,6 +43,21 @@ op-build Release Notes
    v2.0.9
    v2.0.10
    v2.0.11
+
+v2.1
+----
+
+.. toctree::
+   :maxdepth: 1
+
    v2.1-rc1
    v2.1
+
+v2.2
+----
+
+ .. toctree::
+   :maxdepth: 1
+
    v2.2-rc1
+
diff --git a/doc/release-notes/v2.0.10.rst b/doc/release-notes/v2.0.10.rst
index a07b94dd..b3ed7f70 100644
--- a/doc/release-notes/v2.0.10.rst
+++ b/doc/release-notes/v2.0.10.rst
@@ -93,12 +93,12 @@ Package: hostboot
 
 `Repository <https://github.com/open-power/hostboot>`__
 
-.. _patches-1:
+.. _op-build-v2.0.10-patches-1:
 
 Patches
 ~~~~~~~
 
-.. _commits-1:
+.. _op-build-v2.0.10-commits-1:
 
 Commits
 ~~~~~~~
@@ -151,12 +151,12 @@ Package: occ
 
 `Repository <https://github.com/open-power/occ>`__
 
-.. _patches-2:
+.. _op-build-v2.0.10-patches-2:
 
 Patches
 ~~~~~~~
 
-.. _commits-2:
+.. _op-build-v2.0.10-commits-2:
 
 Commits
 ~~~~~~~
@@ -170,14 +170,14 @@ Package: petitboot
 
 `Repository <https://github.com/open-power/petitboot>`__
 
-.. _patches-3:
+.. _op-build-v2.0.10-patches-3:
 
 Patches
 ~~~~~~~
 
 -  `petitboot-01-autotools-Add-autopoint-generated-files.patch <https://github.com/open-power/op-build/tree/HEAD/openpower/package/petitboot/petitboot-01-autotools-Add-autopoint-generated-files.patch>`__
 
-.. _commits-3:
+.. _op-build-v2.0.10-commits-3:
 
 Commits
 ~~~~~~~
@@ -191,12 +191,12 @@ Package: sbe
 
 `Repository <https://github.com/open-power/sbe>`__
 
-.. _patches-4:
+.. _op-build-v2.0.10-patches-4:
 
 Patches
 ~~~~~~~
 
-.. _commits-4:
+.. _op-build-v2.0.10-commits-4:
 
 Commits
 ~~~~~~~
@@ -234,12 +234,12 @@ Package: skiboot
 
 `Repository <https://github.com/open-power/skiboot>`__
 
-.. _patches-5:
+.. _op-build-v2.0.10-patches-5:
 
 Patches
 ~~~~~~~
 
-.. _commits-5:
+.. _op-build-v2.0.10-commits-5:
 
 Commits
 ~~~~~~~
diff --git a/doc/release-notes/v2.0.3.rst b/doc/release-notes/v2.0.3.rst
index fff4683c..ed752c1d 100644
--- a/doc/release-notes/v2.0.3.rst
+++ b/doc/release-notes/v2.0.3.rst
@@ -65,12 +65,12 @@ Package: hostboot
 
 `Repository <https://github.com/open-power/hostboot>`__
 
-.. _patches-1:
+.. _op-build-v2.0.3-patches-1:
 
 Patches
 ~~~~~~~
 
-.. _commits-1:
+.. _op-build-v2.0.3-commits-1:
 
 Commits
 ~~~~~~~
@@ -153,12 +153,12 @@ Package: occ
 
 `Repository <https://github.com/open-power/occ>`__
 
-.. _patches-2:
+.. _op-build-v2.0.3-patches-2:
 
 Patches
 ~~~~~~~
 
-.. _commits-2:
+.. _op-build-v2.0.3-commits-2:
 
 Commits
 ~~~~~~~
@@ -173,12 +173,12 @@ Package: sbe
 
 `Repository <https://github.com/open-power/sbe>`__
 
-.. _patches-3:
+.. _op-build-v2.0.3-patches-3:
 
 Patches
 ~~~~~~~
 
-.. _commits-3:
+.. _op-build-v2.0.3-commits-3:
 
 Commits
 ~~~~~~~
@@ -193,12 +193,12 @@ Package: skiboot
 
 `Repository <https://github.com/open-power/skiboot>`__
 
-.. _patches-4:
+.. _op-build-v2.0.3-patches-4:
 
 Patches
 ~~~~~~~
 
-.. _commits-4:
+.. _op-build-v2.0.3-commits-4:
 
 Commits
 ~~~~~~~
diff --git a/doc/release-notes/v2.0.9.rst b/doc/release-notes/v2.0.9.rst
index 6660f3fe..ade429bc 100644
--- a/doc/release-notes/v2.0.9.rst
+++ b/doc/release-notes/v2.0.9.rst
@@ -7,6 +7,7 @@ the 2.0.x series.
 It is recommended that v2.0.9 be used over any previous v2.0.x version on POWER9 systems due to the bug fixes contained within.
 
 The only update in this release is to skiboot. Skiboot v6.0.8 includes the following bug fixes:
+
 - i2c: Ensure ordering between i2c_request_send() and completion
 
   i2c_request_send loops waiting for a flag "uc.done" set by
diff --git a/doc/release-notes/v2.2-rc1.rst b/doc/release-notes/v2.2-rc1.rst
index 0ceb1f55..6212daef 100644
--- a/doc/release-notes/v2.2-rc1.rst
+++ b/doc/release-notes/v2.2-rc1.rst
@@ -153,12 +153,12 @@ Package: hcode
 
 `Repository <https://github.com/open-power/hcode>`__
 
-.. _patches-1:
+.. _op-build-v2.2-rc1-patches-1:
 
 Patches
 ~~~~~~~
 
-.. _commits-1:
+.. _op-build-v2.2-rc1-commits-1:
 
 Commits
 ~~~~~~~
@@ -790,7 +790,7 @@ Package: hostboot
 
 `Repository <https://github.com/open-power/hostboot>`__
 
-.. _patches-2:
+.. _op-build-v2.2-rc1-patches-2:
 
 Patches
 ~~~~~~~
@@ -799,7 +799,7 @@ Patches
 -  `hostboot-0002-Revert-Mark-Read-Only-Partitions-as-Such.patch <https://github.com/open-power/op-build/tree/HEAD/openpower/package/hostboot/hostboot-0002-Revert-Mark-Read-Only-Partitions-as-Such.patch>`__
 -  `hostboot-1020-Revert-jgr17071200-Removed-pdwn-settings.patch <https://github.com/open-power/op-build/tree/HEAD/openpower/package/hostboot/hostboot-1020-Revert-jgr17071200-Removed-pdwn-settings.patch>`__
 
-.. _commits-2:
+.. _op-build-v2.2-rc1-commits-2:
 
 Commits
 ~~~~~~~
@@ -2916,12 +2916,12 @@ Package: occ
 
 `Repository <https://github.com/open-power/occ>`__
 
-.. _patches-3:
+.. _op-build-v2.2-rc1-patches-3:
 
 Patches
 ~~~~~~~
 
-.. _commits-3:
+.. _op-build-v2.2-rc1-commits-3:
 
 Commits
 ~~~~~~~
@@ -3001,12 +3001,12 @@ Package: op-build
 
 `Repository <https://github.com/open-power/op-build>`__
 
-.. _patches-4:
+.. _op-build-v2.2-rc1-patches-4:
 
 Patches
 ~~~~~~~
 
-.. _commits-4:
+.. _op-build-v2.2-rc1-commits-4:
 
 Commits
 ~~~~~~~
@@ -3018,12 +3018,12 @@ Package: p9dsu-xml
 
 `Repository <https://github.com/open-power/p9dsu-xml>`__
 
-.. _patches-5:
+.. _op-build-v2.2-rc1-patches-5:
 
 Patches
 ~~~~~~~
 
-.. _commits-5:
+.. _op-build-v2.2-rc1-commits-5:
 
 Commits
 ~~~~~~~
@@ -3035,12 +3035,12 @@ Package: palmetto-xml
 
 `Repository <https://github.com/open-power/palmetto-xml>`__
 
-.. _patches-6:
+.. _op-build-v2.2-rc1-patches-6:
 
 Patches
 ~~~~~~~
 
-.. _commits-6:
+.. _op-build-v2.2-rc1-commits-6:
 
 Commits
 ~~~~~~~
@@ -3055,14 +3055,14 @@ Package: petitboot
 
 `Repository <https://github.com/open-power/petitboot>`__
 
-.. _patches-7:
+.. _op-build-v2.2-rc1-patches-7:
 
 Patches
 ~~~~~~~
 
 -  `petitboot-01-autotools-Add-autopoint-generated-files.patch <https://github.com/open-power/op-build/tree/HEAD/openpower/package/petitboot/petitboot-01-autotools-Add-autopoint-generated-files.patch>`__
 
-.. _commits-7:
+.. _op-build-v2.2-rc1-commits-7:
 
 Commits
 ~~~~~~~
@@ -3072,12 +3072,12 @@ Package: pnor
 
 `Repository <https://github.com/open-power/pnor>`__
 
-.. _patches-8:
+.. _op-build-v2.2-rc1-patches-8:
 
 Patches
 ~~~~~~~
 
-.. _commits-8:
+.. _op-build-v2.2-rc1-commits-8:
 
 Commits
 ~~~~~~~
@@ -3089,12 +3089,12 @@ Package: romulus-xml
 
 `Repository <https://github.com/open-power/romulus-xml>`__
 
-.. _patches-9:
+.. _op-build-v2.2-rc1-patches-9:
 
 Patches
 ~~~~~~~
 
-.. _commits-9:
+.. _op-build-v2.2-rc1-commits-9:
 
 Commits
 ~~~~~~~
@@ -3131,12 +3131,12 @@ Package: sbe
 
 `Repository <https://github.com/open-power/sbe>`__
 
-.. _patches-10:
+.. _op-build-v2.2-rc1-patches-10:
 
 Patches
 ~~~~~~~
 
-.. _commits-10:
+.. _op-build-v2.2-rc1-commits-10:
 
 Commits
 ~~~~~~~
@@ -3478,12 +3478,12 @@ Package: skiboot
 
 `Repository <https://github.com/open-power/skiboot>`__
 
-.. _patches-11:
+.. _op-build-v2.2-rc1-patches-11:
 
 Patches
 ~~~~~~~
 
-.. _commits-11:
+.. _op-build-v2.2-rc1-commits-11:
 
 Commits
 ~~~~~~~
@@ -3991,12 +3991,12 @@ Package: vesnin-xml
 
 `Repository <https://github.com/open-power/vesnin-xml>`__
 
-.. _patches-12:
+.. _op-build-v2.2-rc1-patches-12:
 
 Patches
 ~~~~~~~
 
-.. _commits-12:
+.. _op-build-v2.2-rc1-commits-12:
 
 Commits
 ~~~~~~~
@@ -4013,12 +4013,12 @@ Package: witherspoon-xml
 
 `Repository <https://github.com/open-power/witherspoon-xml>`__
 
-.. _patches-13:
+.. _op-build-v2.2-rc1-patches-13:
 
 Patches
 ~~~~~~~
 
-.. _commits-13:
+.. _op-build-v2.2-rc1-commits-13:
 
 Commits
 ~~~~~~~
@@ -4033,12 +4033,12 @@ Package: zaius-xml
 
 `Repository <https://github.com/open-power/zaius-xml>`__
 
-.. _patches-14:
+.. _op-build-v2.2-rc1-patches-14:
 
 Patches
 ~~~~~~~
 
-.. _commits-14:
+.. _op-build-v2.2-rc1-commits-14:
 
 Commits
 ~~~~~~~