Merge pull request #2220 from stackhpc/doc-fixes

Fix several broken links in documentation

Author: priteau

doc/source/configuration/openbao.rst

@@ -236,8 +236,8 @@ Certificates generation
 Create the external TLS certificates (testing only)
 ---------------------------------------------------
 
-This method should only be used for testing. For external TLS on production systems,
-See `Installing External TLS Certificates <installing-external-tls-certificates>`__.
+This method should only be used for testing. For external TLS on production
+systems, see :ref:`installing-external-tls-certificates`.
 
 Typically external API TLS certificates should be generated by a organisation's trusted internal or third-party CA.
 For test and development purposes it is possible to use OpenBao as a CA for the external API.

doc/source/contributor/ofed.rst

@@ -86,7 +86,7 @@ to be reset before rebooting.
   kayobe playbook run $KAYOBE_CONFIG_PATH/ansible/maintenance/reset-bls-entries.yml -e reset_bls_host=mlnx
 
 The hosts can now be rebooted to use the latest kernel, a rolling reboot may be applicable
-here to reduce distruptions. See the `package updates documentation <package-updates>`.
+here to reduce disruptions. See the :doc:`package updates documentation <package-updates>`.
 
 .. code-block:: console
 

doc/source/operations/openstack-reconfiguration.rst

@@ -41,8 +41,7 @@ Installing External TLS Certificates
 ====================================
 
 This section explains the process of deploying external TLS.
-For internal and backend TLS, see `Hashicorp Vault for internal PKI
-<hashicorp-vault>`__.
+For internal and backend TLS, see :doc:`/configuration/openbao`.
 
 To configure TLS for the first time, we write the contents of a PEM
 file to the ``secrets.yml`` file as ``secrets_kolla_external_tls_cert``.