Use autosectionlabel_prefix_document

docs/conf.py

@@ -66,3 +66,4 @@ master_doc = 'index'
 #
 # https://www.sphinx-doc.org/en/master/usage/configuration.html#confval-suppress_warnings
 suppress_warnings = ['autosectionlabel.*']
+autosectionlabel_prefix_document = True

docs/security.rst

@@ -12,7 +12,7 @@ If you like to limit who can access your cluster resources you can configure
 the OAS ingress (`ingress-nginx <https://kubernetes.github.io/ingress-nginx>`__)
 to only accept connections from a certain IP address or range.
 
-Follow the :ref:`Customize OAS applications` instructions, but use the following
+Follow the :ref:`advanced_installation:Customize OAS applications` instructions, but use the following
 secret as ``install/overrides/oas-nginx-override.yml`` and apply the secret in
 the ``oas`` namespace instead of ``oas-apps``. Replace the source range with the
 IP address ranges you want to allow.

docs/testing.rst

@@ -18,13 +18,13 @@ Testing OAS installation
 ------------------------
 
 First we’d like you to setup an OpenAppStack cluster by yourself,
-following the `installation
-instructions <https://docs.openappstack.net/en/latest/installation.html>`__.
+following the :ref:`installation:Installation` and :ref:`usage:Usage` documentation and make sure
+you complete all steps.
 
 Command line tests
 ------------------
 
-Please :ref:`Run the CLI tests` which checks
+Please :ref:`troubleshooting:Run the CLI tests` which checks
 the overall functionality of your cluster and include the output in your
 feedback.
 

docs/upgrading.rst

@@ -159,7 +159,7 @@ A few things are important when upgrading to 0.6.0:
 - We now use Flux 2 and the installation procedure has been overhauled. For this
   reason we advice you to set up a completely new cluster.
 - Copy your configuration details from ``settings.yaml`` to a new ``.flux.env``.
-  See ``install/.flux.env.example`` and the :ref:`Installation`
+  See ``install/.flux.env.example`` and the :ref:`installation:Installation`
   instructions for more information.
 
 Please `reach out to us`_ if you are using, or plan to use OAS in