diff --git a/docs/ci/hidden-jobs/build-freertos.rst b/docs/ci/hidden-jobs/build-freertos.rst
index 6159bbf27ec95fd97d72f3a3ed2adfb889e6866b..e6007f0601d20ab47f21a0071762d20d85b6cb4e 100644
--- a/docs/ci/hidden-jobs/build-freertos.rst
+++ b/docs/ci/hidden-jobs/build-freertos.rst
@@ -14,4 +14,4 @@ Usage Guide
 ===========
 
 This job is not intended for direct use. Instead it serves as a base for all
-the FreeRTOS-specific :doc:`../shared-jobs`.
+the FreeRTOS-specific :doc:`../machines-and-flavours`.
diff --git a/docs/ci/hidden-jobs/build-linux.rst b/docs/ci/hidden-jobs/build-linux.rst
index 21b515004bae4f62bdc002767dec30576d350f2c..2f51ab56f914e25f6936b111a9965443fde8404c 100644
--- a/docs/ci/hidden-jobs/build-linux.rst
+++ b/docs/ci/hidden-jobs/build-linux.rst
@@ -18,8 +18,9 @@ Usage Guide
 ===========
 
 This job is not intended for direct use. Instead it serves as a base for all
-the Linux-specific :doc:`../shared-jobs`. It may be re-defined in a pipeline to
-alter ``rules`` or ``variables`` in a way that fits a particular purpose.
+the Linux-specific :doc:`../machines-and-flavours`. It may be re-defined in a
+pipeline to alter ``rules`` or ``variables`` in a way that fits a particular
+purpose.
 
 If used directly, it is recommended pick the desired ``MACHINE`` and to
 override the entire script section and refer to the base ``.bitbake-workspace``
diff --git a/docs/ci/hidden-jobs/build-zephyr.rst b/docs/ci/hidden-jobs/build-zephyr.rst
index e966cfc9717f0494aa207972bde248a210ee0463..70c25eb166f849ca5b36dd4868a8e38e64383680 100644
--- a/docs/ci/hidden-jobs/build-zephyr.rst
+++ b/docs/ci/hidden-jobs/build-zephyr.rst
@@ -14,4 +14,4 @@ Usage Guide
 ===========
 
 This job is not intended for direct use. Instead it serves as a base for all
-the Zephyr-specific :doc:`../shared-jobs`.
+the Zephyr-specific :doc:`../machines-and-flavours`.
diff --git a/docs/ci/hidden-jobs/index.rst b/docs/ci/hidden-jobs/index.rst
index e1f9cd7aa2cb32701dec78bab208085921bb18b4..b21cb44a68dfcd235f208daf31a8dc1f64e4eff0 100644
--- a/docs/ci/hidden-jobs/index.rst
+++ b/docs/ci/hidden-jobs/index.rst
@@ -6,7 +6,7 @@ Hidden Jobs
 ===========
 
 There's a number of *hidden jobs*, which start with the dot character, that are
-used as foundation for the set of :doc:`shared jobs <../shared-jobs>`. Hidden
+used as foundation for the set of :doc:`../machines-and-flavours`. Hidden
 jobs do not participate in any pipeline directly. They can only be used as
 templates, using the ``extends: ...`` mechanism, to share and reuse
 implementation details.