diff --git a/docs/devel/index.rst b/docs/devel/index.rst index daaedaf1956fb4fe2528fbff1d61010fc02998dd..cfb5896940c47a58700984d8a92452b9bf36c587 100644 --- a/docs/devel/index.rst +++ b/docs/devel/index.rst @@ -60,10 +60,10 @@ Roadmap System Administration ^^^^^^^^^^^^^^^^^^^^^ -* :ref:`Network Infrastructure <swh-sysadm:infrastructure>` -* :ref:`swh-sysadm:mirror` → learn what a Software Heritage mirror is and how to set up +* :ref:`Network Infrastructure <infrastructure>` +* :ref:`mirror` → learn what a Software Heritage mirror is and how to set up one -* :ref:`Keycloak <swh-sysadm:keycloak>` → learn how to use Keycloak, +* :ref:`Keycloak <keycloak>` → learn how to use Keycloak, the authentication system used by |swh|'s web interface and public APIs .. _components: diff --git a/docs/devel/infrastructure.rst b/docs/devel/infrastructure.rst index bff3bf51242703e1fb9ebf1e8c1f99369ac211dd..c34975a82856d32d6ef07b3e85e9ece356c0dae9 100644 --- a/docs/devel/infrastructure.rst +++ b/docs/devel/infrastructure.rst @@ -1,3 +1,3 @@ :orphan: -This page was moved to: :ref:`swh-sysadm:infrastructure`. +This page was moved to: :ref:`infrastructure`. diff --git a/docs/devel/keycloak.rst b/docs/devel/keycloak.rst index 4d574687128ac8c0798609be4dd34620cd2eba94..d3ca004b17c1601f896bf8679a9ce7e1fe45e1ef 100644 --- a/docs/devel/keycloak.rst +++ b/docs/devel/keycloak.rst @@ -1,3 +1,3 @@ :orphan: -This page was moved to: :ref:`swh-sysadm:keycloak`. +This page was moved to: :ref:`keycloak`. diff --git a/docs/sysadm/deployment/deploy-lister.rst b/docs/sysadm/deployment/deploy-lister.rst index 1397cfda08a7e751c3519120c07346e8c01e27d1..afcad54678fc2a0b3c1bbfae78142907adf5f7d1 100644 --- a/docs/sysadm/deployment/deploy-lister.rst +++ b/docs/sysadm/deployment/deploy-lister.rst @@ -153,7 +153,7 @@ Register a new task ------------------- The listers and the scheduler are now ready to work together. Use the `swh scheduler -task add` command. Check ref:`swh-devel:register-task-type` for more details. +task add` command. Check ref:`register-task-type` for more details. .. _check-logs: diff --git a/docs/sysadm/mirror-operations/onboard.rst b/docs/sysadm/mirror-operations/onboard.rst index fb2e7454256554439ff4a4119160226c60b28df0..15203fd1991da8910a1eec8908fde3949b3cbbaa 100644 --- a/docs/sysadm/mirror-operations/onboard.rst +++ b/docs/sysadm/mirror-operations/onboard.rst @@ -110,7 +110,7 @@ For example, to add a user ``new-mirror-stg`` in the staging's journal: How to use the credentials -------------------------- -Refer to the :ref:`journal client authentication configuration <swh-devel:journal-client-authentication>`. +Refer to the :ref:`journal client authentication configuration <journal-client-authentication>`. How to create the objstorage credentials ---------------------------------------- diff --git a/docs/sysadm/puppet/howto-manage-third-party-modules.rst b/docs/sysadm/puppet/howto-manage-third-party-modules.rst index 0b2e1e4bcf7a77cf645af4002f36827abdfd1f78..521c1bf659dc2c2bf7871c7cc095b71f744f5017 100644 --- a/docs/sysadm/puppet/howto-manage-third-party-modules.rst +++ b/docs/sysadm/puppet/howto-manage-third-party-modules.rst @@ -45,7 +45,7 @@ To be able to use the script, you need: - Be a member of the `System Administrators <https://forge.softwareheritage.org/project/members/7/>`_ Phabricator group -- Have the :ref:`Arcanist <swh-devel:arcanist-configuration>` API key setup +- Have the :ref:`Arcanist <arcanist-configuration>` API key setup - A pair of python dependencies: ``python3-phabricator`` and ``python3-requests`` (pull them from testing if needed). diff --git a/docs/sysadm/user-management/onboarding.rst b/docs/sysadm/user-management/onboarding.rst index de89947161a1bace313c969bde2e9c98fe5d7ecc..ce49ee08da72bfa69f0dfdf0029c66c24fc17bd7 100644 --- a/docs/sysadm/user-management/onboarding.rst +++ b/docs/sysadm/user-management/onboarding.rst @@ -91,14 +91,14 @@ Communication Training -------- -- Read `data model <swh-devel:data-model>`_ +- Read `data model <data-model>`_ - Read `python modules structure <https://docs.softwareheritage.org/devel/#dependencies>`_ - Follow `getting started tutorial <https://docs.softwareheritage.org/devel/getting-started.html>`_ - Have ``make check`` and ``make test`` pass there in swh-environment -- `Configure arcanist <swh-devel:arcanist-configuration>`_ and submit a first diff - following the `code review <swh-devel:code-review>`_ workflow +- `Configure arcanist <arcanist-configuration>`_ and submit a first diff + following the `code review <code-review>`_ workflow .. _onboarding_see_also: diff --git a/docs/user/faq/index.rst b/docs/user/faq/index.rst index 730f6df39f3016d0fa2a33d2bec48786fe5defcb..3200f85324044869d2f7ec8115c116593650f9c1 100644 --- a/docs/user/faq/index.rst +++ b/docs/user/faq/index.rst @@ -16,7 +16,7 @@ Roadmap Where can I find the SWH roadmap? --------------------------------- -The roadmap is accessible on the :ref:`development docs <swh-devel:roadmap-2021>`. +The roadmap is accessible on the :ref:`development docs <roadmap-2021>`. .. _faq_savecodenow: