From acee0c871c5d0ef83990caf1a798aee239cbc4ba Mon Sep 17 00:00:00 2001 From: technowhizz <7688823+technowhizz@users.noreply.github.com> Date: Tue, 4 Mar 2025 11:43:03 +0000 Subject: [PATCH 1/4] Fix broken upstream doc link --- doc/source/configuration/cephadm.rst | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/doc/source/configuration/cephadm.rst b/doc/source/configuration/cephadm.rst index 19112a083..7364528d1 100644 --- a/doc/source/configuration/cephadm.rst +++ b/doc/source/configuration/cephadm.rst @@ -353,7 +353,7 @@ RADOS Gateways RADOS Gateway integration is described in the :kolla-ansible-doc:`Kolla Ansible documentation -`. +`. RADOS Gateways (RGWs) are defined with the following: From d3f338e00ba6b3b786848c261c6944338b45ede4 Mon Sep 17 00:00:00 2001 From: technowhizz <7688823+technowhizz@users.noreply.github.com> Date: Tue, 4 Mar 2025 11:45:30 +0000 Subject: [PATCH 2/4] Ensure all Kayobe, Kolla & Kolla Ansible docs links use extlinks --- doc/source/configuration/cephadm.rst | 8 ++++---- doc/source/configuration/ci-cd.rst | 2 +- doc/source/configuration/cloudkitty.rst | 4 ++-- 3 files changed, 7 insertions(+), 7 deletions(-) diff --git a/doc/source/configuration/cephadm.rst b/doc/source/configuration/cephadm.rst index 7364528d1..778e3a961 100644 --- a/doc/source/configuration/cephadm.rst +++ b/doc/source/configuration/cephadm.rst @@ -208,8 +208,8 @@ Pools ~~~~~ The following example pools should be sufficient to work with the -default `external Ceph -configuration `__ +default :kolla-ansible-doc:`external Ceph +configuration ` for Cinder, Cinder backup, Glance, and Nova in Kolla Ansible. .. code:: yaml @@ -236,8 +236,8 @@ Keys ~~~~ The following example keys should be sufficient to work with the default -`external Ceph -configuration `__ +:kolla-ansible-doc:`external Ceph +configuration ` for Cinder, Cinder backup, Glance, and Nova in Kolla Ansible. .. code:: yaml diff --git a/doc/source/configuration/ci-cd.rst b/doc/source/configuration/ci-cd.rst index dcf86350e..435c114f7 100644 --- a/doc/source/configuration/ci-cd.rst +++ b/doc/source/configuration/ci-cd.rst @@ -118,7 +118,7 @@ Runner Deployment The repository permissions for a fine-grained personal access token should be; :code:`Actions: R/W, Administration: R/W, Metadata: R` Once the key has been obtained, add it to :code:`secrets.yml` under :code:`secrets_github_access_token` -7. If the host is an actual Infra VM then please refer to upstream `Infrastructure VMs `__ documentation for additional configuration and steps. +7. If the host is an actual Infra VM then please refer to upstream :kayobe-doc:`Infrastructure VMs ` documentation for additional configuration and steps. 8. Run :code:`kayobe playbook run $KAYOBE_CONFIG_PATH/ansible/deploy-github-runner.yml` diff --git a/doc/source/configuration/cloudkitty.rst b/doc/source/configuration/cloudkitty.rst index c2701aa07..acd10541f 100644 --- a/doc/source/configuration/cloudkitty.rst +++ b/doc/source/configuration/cloudkitty.rst @@ -8,8 +8,8 @@ Configuring in kayobe-config By default, CloudKitty uses Gnocchi and Ceilometer as the collector and fetcher backends. Unless the system has a specific reason not to, we recommend instead using Prometheus as the backend for both. The following instructions explain -how to do this. Also, see the `Kolla Ansible docs on CloudKitty -`__ +how to do this. Also, see the :kolla-ansible-doc:`Kolla Ansible docs on CloudKitty +` for more details. Enable CloudKitty and disable InfluxDB, as we are using OpenSearch as the From 745faa7d49e48ca924e8f7ad863ae80e4acc05dd Mon Sep 17 00:00:00 2001 From: technowhizz <7688823+technowhizz@users.noreply.github.com> Date: Tue, 4 Mar 2025 11:46:53 +0000 Subject: [PATCH 3/4] Remove extra '/' at the end of links --- doc/source/index.rst | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/doc/source/index.rst b/doc/source/index.rst index be1320948..85d3c4697 100644 --- a/doc/source/index.rst +++ b/doc/source/index.rst @@ -12,8 +12,8 @@ Overview ======== This documentation covers the StackHPC Kayobe configuration. It is intended to -complement, rather than replace, the upstream :kayobe-doc:`Kayobe `, -:kolla-doc:`Kolla ` and :kolla-ansible-doc:`Kolla Ansible ` +complement, rather than replace, the upstream :kayobe-doc:`Kayobe <>`, +:kolla-doc:`Kolla <>` and :kolla-ansible-doc:`Kolla Ansible<>` documentation. The configuration includes various things, such as: From e82adff99e13d9870fb1c03d16c54ab2b152ddd6 Mon Sep 17 00:00:00 2001 From: technowhizz <7688823+technowhizz@users.noreply.github.com> Date: Tue, 4 Mar 2025 11:53:39 +0000 Subject: [PATCH 4/4] Add reno --- releasenotes/notes/fix-broken-links-150bf2dd009123d1.yaml | 4 ++++ 1 file changed, 4 insertions(+) create mode 100644 releasenotes/notes/fix-broken-links-150bf2dd009123d1.yaml diff --git a/releasenotes/notes/fix-broken-links-150bf2dd009123d1.yaml b/releasenotes/notes/fix-broken-links-150bf2dd009123d1.yaml new file mode 100644 index 000000000..8d65779e0 --- /dev/null +++ b/releasenotes/notes/fix-broken-links-150bf2dd009123d1.yaml @@ -0,0 +1,4 @@ +--- +fixes: + - | + Fix some broken links in the docs.