samples: hello_world: use zephyr:code-sample directive

Adds missing code-sample directive to the Hello World sample in
preparation for upcoming changes to the Zephyr documentation that will
be leveraging the provided description and metadata.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
diff --git a/boards/96boards/aerocore2/doc/index.rst b/boards/96boards/aerocore2/doc/index.rst
index ca12b69..489433e 100644
--- a/boards/96boards/aerocore2/doc/index.rst
+++ b/boards/96boards/aerocore2/doc/index.rst
@@ -311,7 +311,7 @@
    usb 1-2.1: SerialNumber: 3574364C3034
 
 Then build and flash an application. Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/96boards/argonkey/doc/index.rst b/boards/96boards/argonkey/doc/index.rst
index 810ab2e..f5cc913 100644
--- a/boards/96boards/argonkey/doc/index.rst
+++ b/boards/96boards/argonkey/doc/index.rst
@@ -145,7 +145,7 @@
 Building
 ========
 
-Here is an example for building the :ref:`hello_world` application.
+Here is an example for building the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/96boards/carbon/doc/stm32f401xe.rst b/boards/96boards/carbon/doc/stm32f401xe.rst
index 8f0d38c..c493c0a 100644
--- a/boards/96boards/carbon/doc/stm32f401xe.rst
+++ b/boards/96boards/carbon/doc/stm32f401xe.rst
@@ -299,7 +299,7 @@
    usb 1-2.1: SerialNumber: 3574364C3034
 
 Then build and flash an application. Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/96boards/neonkey/doc/index.rst b/boards/96boards/neonkey/doc/index.rst
index 9630878..df9fb16 100644
--- a/boards/96boards/neonkey/doc/index.rst
+++ b/boards/96boards/neonkey/doc/index.rst
@@ -135,7 +135,7 @@
 Building
 ========
 
-Here is an example for building the :ref:`hello_world` application.
+Here is an example for building the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/96boards/nitrogen/doc/index.rst b/boards/96boards/nitrogen/doc/index.rst
index 952f112..df3d023 100644
--- a/boards/96boards/nitrogen/doc/index.rst
+++ b/boards/96boards/nitrogen/doc/index.rst
@@ -273,7 +273,7 @@
 Flashing an Application to 96Boards Nitrogen
 ============================================
 
-Here is an example for the :ref:`hello_world` application. This
+Here is an example for the :zephyr:code-sample:`hello_world` application. This
 requires installing the :ref:`pyocd-debug-host-tools`.
 
 .. zephyr-app-commands::
@@ -302,7 +302,7 @@
 ==================
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application. This also requires pyOCD.
+:zephyr:code-sample:`hello_world` application. This also requires pyOCD.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/96boards/stm32_sensor_mez/doc/index.rst b/boards/96boards/stm32_sensor_mez/doc/index.rst
index 350d472..1539a81 100644
--- a/boards/96boards/stm32_sensor_mez/doc/index.rst
+++ b/boards/96boards/stm32_sensor_mez/doc/index.rst
@@ -181,7 +181,7 @@
 Building
 ========
 
-Here is an example for building the :ref:`hello_world` application.
+Here is an example for building the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -198,7 +198,7 @@
 Flashing an application to 96Boards STM32 Sensor Mezzanine
 ----------------------------------------------------------
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 Run a serial host program to connect with your 96Boards STM32 Sensor Mezzanine
 board.
@@ -224,7 +224,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/96boards/wistrio/doc/96b_wistrio.rst b/boards/96boards/wistrio/doc/96b_wistrio.rst
index 14f93e6..8db31fc 100644
--- a/boards/96boards/wistrio/doc/96b_wistrio.rst
+++ b/boards/96boards/wistrio/doc/96b_wistrio.rst
@@ -148,7 +148,7 @@
 Chapter 29 of Application note `AN2606`_. The ROM bootloader supports flashing
 via UART, and I2C protocols.
 
-Here is an example for building and flashing the :ref:`hello_world` application using `stm32flash`_ command line utility:
+Here is an example for building and flashing the :zephyr:code-sample:`hello_world` application using `stm32flash`_ command line utility:
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/adafruit/feather_m0_basic_proto/doc/index.rst b/boards/adafruit/feather_m0_basic_proto/doc/index.rst
index a9dc7f0..0420678 100644
--- a/boards/adafruit/feather_m0_basic_proto/doc/index.rst
+++ b/boards/adafruit/feather_m0_basic_proto/doc/index.rst
@@ -110,7 +110,7 @@
 Flashing
 ========
 
-#. Build the Zephyr kernel and the :ref:`hello_world` sample application:
+#. Build the Zephyr kernel and the :zephyr:code-sample:`hello_world` sample application:
 
    .. zephyr-app-commands::
       :zephyr-app: samples/hello_world
diff --git a/boards/adafruit/feather_m0_lora/doc/index.rst b/boards/adafruit/feather_m0_lora/doc/index.rst
index 3303c6e..b75f73d 100644
--- a/boards/adafruit/feather_m0_lora/doc/index.rst
+++ b/boards/adafruit/feather_m0_lora/doc/index.rst
@@ -119,7 +119,7 @@
 Flashing
 ========
 
-#. Build the Zephyr kernel and the :ref:`hello_world` sample application:
+#. Build the Zephyr kernel and the :zephyr:code-sample:`hello_world` sample application:
 
    .. zephyr-app-commands::
       :zephyr-app: samples/hello_world
diff --git a/boards/adafruit/grand_central_m4_express/doc/index.rst b/boards/adafruit/grand_central_m4_express/doc/index.rst
index ec8ab08..e9cf733 100644
--- a/boards/adafruit/grand_central_m4_express/doc/index.rst
+++ b/boards/adafruit/grand_central_m4_express/doc/index.rst
@@ -111,7 +111,7 @@
 Flashing
 ========
 
-#. Build the Zephyr kernel and the :ref:`hello_world` sample application:
+#. Build the Zephyr kernel and the :zephyr:code-sample:`hello_world` sample application:
 
    .. zephyr-app-commands::
       :zephyr-app: samples/hello_world
diff --git a/boards/adafruit/itsybitsy_m4_express/doc/index.rst b/boards/adafruit/itsybitsy_m4_express/doc/index.rst
index a25df0b..ce3efb8 100644
--- a/boards/adafruit/itsybitsy_m4_express/doc/index.rst
+++ b/boards/adafruit/itsybitsy_m4_express/doc/index.rst
@@ -122,7 +122,7 @@
 Flashing
 ========
 
-#. Build the Zephyr kernel and the :ref:`hello_world` sample application:
+#. Build the Zephyr kernel and the :zephyr:code-sample:`hello_world` sample application:
 
    .. zephyr-app-commands::
       :zephyr-app: samples/hello_world
diff --git a/boards/adafruit/nrf52_adafruit_feather/doc/index.rst b/boards/adafruit/nrf52_adafruit_feather/doc/index.rst
index 0e7680e..1fff89a 100644
--- a/boards/adafruit/nrf52_adafruit_feather/doc/index.rst
+++ b/boards/adafruit/nrf52_adafruit_feather/doc/index.rst
@@ -118,10 +118,10 @@
 applications as usual (see :ref:`build_an_application` and
 :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 
-#. Build the Zephyr kernel and the :ref:`hello_world` sample application:
+#. Build the Zephyr kernel and the :zephyr:code-sample:`hello_world` sample application:
 
    .. zephyr-app-commands::
       :zephyr-app: samples/hello_world
diff --git a/boards/adafruit/trinket_m0/doc/index.rst b/boards/adafruit/trinket_m0/doc/index.rst
index 4e23822..e02b829 100644
--- a/boards/adafruit/trinket_m0/doc/index.rst
+++ b/boards/adafruit/trinket_m0/doc/index.rst
@@ -114,7 +114,7 @@
 Flashing
 ========
 
-#. Build the Zephyr kernel and the :ref:`hello_world` sample application:
+#. Build the Zephyr kernel and the :zephyr:code-sample:`hello_world` sample application:
 
    .. zephyr-app-commands::
       :zephyr-app: samples/hello_world
diff --git a/boards/adi/eval_adin1110ebz/doc/index.rst b/boards/adi/eval_adin1110ebz/doc/index.rst
index 92b70f0..f39a04b 100644
--- a/boards/adi/eval_adin1110ebz/doc/index.rst
+++ b/boards/adi/eval_adin1110ebz/doc/index.rst
@@ -145,7 +145,7 @@
    $ minicom -D /dev/serial/by-id/usb-ADI_EVAL-ADIN1110EBZ_AVAS_XXXXXX-if00-port0
 
 where XXXXXX is the serial number of the connected device.
-Then, build and flash in the usual way. Here is an example for the :ref:`hello_world` application.
+Then, build and flash in the usual way. Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -161,7 +161,7 @@
 Debugging
 =========
 
-You can debug an application in the usual way.  Here is an example for the :ref:`hello_world`
+You can debug an application in the usual way.  Here is an example for the :zephyr:code-sample:`hello_world`
 application.
 
 .. zephyr-app-commands::
diff --git a/boards/adi/eval_adin2111ebz/doc/index.rst b/boards/adi/eval_adin2111ebz/doc/index.rst
index c88e6d5..ea0ce92 100644
--- a/boards/adi/eval_adin2111ebz/doc/index.rst
+++ b/boards/adi/eval_adin2111ebz/doc/index.rst
@@ -146,7 +146,7 @@
    $ minicom -D /dev/serial/by-id/usb-ADI_EVAL-ADIN2111EBZ_XXXXXX-12-if00-port0
 
 where XXXXXX is the serial number of the connected device.
-Then, build and flash in the usual way. Here is an example for the :ref:`hello_world` application.
+Then, build and flash in the usual way. Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -162,7 +162,7 @@
 Debugging
 =========
 
-You can debug an application in the usual way.  Here is an example for the :ref:`hello_world`
+You can debug an application in the usual way.  Here is an example for the :zephyr:code-sample:`hello_world`
 application.
 
 .. zephyr-app-commands::
diff --git a/boards/adi/max32690fthr/doc/index.rst b/boards/adi/max32690fthr/doc/index.rst
index 714adb8..edb480f 100644
--- a/boards/adi/max32690fthr/doc/index.rst
+++ b/boards/adi/max32690fthr/doc/index.rst
@@ -98,7 +98,7 @@
 
 Once the debug probe is connected to your host computer, then you can run the
 ``west flash`` command to write a firmware image into flash. Here is an example
-for the :ref:`hello_world` application.
+for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -118,7 +118,7 @@
 
 Once the debug probe is connected to your host computer, then you can run the
 ``west debug`` command to write a firmware image into flash and start a debug
-session. Here is an example for the :ref:`hello_world` application.
+session. Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/adi/sdp_k1/doc/index.rst b/boards/adi/sdp_k1/doc/index.rst
index 1f6f918..0b23797 100644
--- a/boards/adi/sdp_k1/doc/index.rst
+++ b/boards/adi/sdp_k1/doc/index.rst
@@ -151,7 +151,7 @@
 
    $ minicom -D /dev/serial/by-id/usb-ARM_DAPLink_CMSIS-DAP_<...>
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/alientek/pandora_stm32l475/doc/index.rst b/boards/alientek/pandora_stm32l475/doc/index.rst
index cee292e..082c814 100644
--- a/boards/alientek/pandora_stm32l475/doc/index.rst
+++ b/boards/alientek/pandora_stm32l475/doc/index.rst
@@ -182,7 +182,7 @@
    $ minicom -D /dev/ttyACM0
 
 Then, build and flash in the usual way. Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -199,7 +199,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/altr/max10/doc/index.rst b/boards/altr/max10/doc/index.rst
index 6a35d05..0ff861b 100644
--- a/boards/altr/max10/doc/index.rst
+++ b/boards/altr/max10/doc/index.rst
@@ -147,7 +147,7 @@
 ------------------------
 
 The usual ``flash`` target will work with the ``altera_max10`` board
-configuration. Here is an example for the :ref:`hello_world`
+configuration. Here is an example for the :zephyr:code-sample:`hello_world`
 application.
 
 .. zephyr-app-commands::
diff --git a/boards/ambiq/apollo3_evb/doc/index.rst b/boards/ambiq/apollo3_evb/doc/index.rst
index 1982236..570e1d5 100644
--- a/boards/ambiq/apollo3_evb/doc/index.rst
+++ b/boards/ambiq/apollo3_evb/doc/index.rst
@@ -60,7 +60,7 @@
 -----------------------
 
 Connect your device to your host computer using the JLINK USB port.
-The sample application :ref:`hello_world` is used for this example.
+The sample application :zephyr:code-sample:`hello_world` is used for this example.
 Build the Zephyr kernel and application, then flash it to the device:
 
 .. zephyr-app-commands::
diff --git a/boards/ambiq/apollo3p_evb/doc/index.rst b/boards/ambiq/apollo3p_evb/doc/index.rst
index 58b3542..c06f3b1 100644
--- a/boards/ambiq/apollo3p_evb/doc/index.rst
+++ b/boards/ambiq/apollo3p_evb/doc/index.rst
@@ -60,7 +60,7 @@
 -----------------------
 
 Connect your device to your host computer using the JLINK USB port.
-The sample application :ref:`hello_world` is used for this example.
+The sample application :zephyr:code-sample:`hello_world` is used for this example.
 Build the Zephyr kernel and application, then flash it to the device:
 
 .. zephyr-app-commands::
diff --git a/boards/ambiq/apollo4p_blue_kxr_evb/doc/index.rst b/boards/ambiq/apollo4p_blue_kxr_evb/doc/index.rst
index 33a68ce..3a18762 100644
--- a/boards/ambiq/apollo4p_blue_kxr_evb/doc/index.rst
+++ b/boards/ambiq/apollo4p_blue_kxr_evb/doc/index.rst
@@ -68,7 +68,7 @@
 -----------------------
 
 Connect your device to your host computer using the JLINK USB port.
-The sample application :ref:`hello_world` is used for this example.
+The sample application :zephyr:code-sample:`hello_world` is used for this example.
 Build the Zephyr kernel and application, then flash it to the device:
 
 .. zephyr-app-commands::
diff --git a/boards/ambiq/apollo4p_evb/doc/index.rst b/boards/ambiq/apollo4p_evb/doc/index.rst
index 662b6c4..fef698b 100644
--- a/boards/ambiq/apollo4p_evb/doc/index.rst
+++ b/boards/ambiq/apollo4p_evb/doc/index.rst
@@ -63,7 +63,7 @@
 -----------------------
 
 Connect your device to your host computer using the JLINK USB port.
-The sample application :ref:`hello_world` is used for this example.
+The sample application :zephyr:code-sample:`hello_world` is used for this example.
 Build the Zephyr kernel and application, then flash it to the device:
 
 .. zephyr-app-commands::
diff --git a/boards/andestech/adp_xc7k_ae350/doc/index.rst b/boards/andestech/adp_xc7k_ae350/doc/index.rst
index ee7dc40..3e290dd 100644
--- a/boards/andestech/adp_xc7k_ae350/doc/index.rst
+++ b/boards/andestech/adp_xc7k_ae350/doc/index.rst
@@ -226,7 +226,7 @@
 ========
 
 You can build applications in the usual way. Here is an example for
-the :ref:`hello_world` application.
+the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/arduino/due/doc/index.rst b/boards/arduino/due/doc/index.rst
index 5d98402..dfc6e00 100644
--- a/boards/arduino/due/doc/index.rst
+++ b/boards/arduino/due/doc/index.rst
@@ -175,7 +175,7 @@
 and flashed in the usual way (see :ref:`build_an_application` and
 :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application. After
+Here is an example for the :zephyr:code-sample:`hello_world` application. After
 building the application, press the Reset button before running the
 flash command, so the board will boot into the SAM-BA bootloader and
 be prepared to receive the new program.
diff --git a/boards/arduino/giga_r1/doc/index.rst b/boards/arduino/giga_r1/doc/index.rst
index 0e95653..696844a 100644
--- a/boards/arduino/giga_r1/doc/index.rst
+++ b/boards/arduino/giga_r1/doc/index.rst
@@ -130,7 +130,7 @@
 port to prepare it for flashing. Double click the ``RST`` button to put the
 board into the Arduino Bootloader mode. Then build and flash your application.
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/arduino/mkrzero/doc/index.rst b/boards/arduino/mkrzero/doc/index.rst
index b6fe37d..2ea120d 100644
--- a/boards/arduino/mkrzero/doc/index.rst
+++ b/boards/arduino/mkrzero/doc/index.rst
@@ -130,7 +130,7 @@
 Flashing
 ========
 
-#. Build the Zephyr kernel and the :ref:`hello_world` sample application:
+#. Build the Zephyr kernel and the :zephyr:code-sample:`hello_world` sample application:
 
    .. zephyr-app-commands::
       :zephyr-app: samples/hello_world
diff --git a/boards/arduino/nano_33_iot/doc/index.rst b/boards/arduino/nano_33_iot/doc/index.rst
index 5b87fb5..e6a5119 100644
--- a/boards/arduino/nano_33_iot/doc/index.rst
+++ b/boards/arduino/nano_33_iot/doc/index.rst
@@ -118,7 +118,7 @@
 Flashing
 ========
 
-#. Build the Zephyr kernel and the :ref:`hello_world` sample application:
+#. Build the Zephyr kernel and the :zephyr:code-sample:`hello_world` sample application:
 
    .. zephyr-app-commands::
       :zephyr-app: samples/hello_world
diff --git a/boards/arduino/nicla_sense_me/doc/index.rst b/boards/arduino/nicla_sense_me/doc/index.rst
index 6a6eb3a..1bf984f 100644
--- a/boards/arduino/nicla_sense_me/doc/index.rst
+++ b/boards/arduino/nicla_sense_me/doc/index.rst
@@ -95,7 +95,7 @@
 First, connect the Arduino Nicla Sense ME board to your host computer using
 the USB port to prepare it for flashing. Then build and flash your application.
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -118,7 +118,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/arduino/nicla_vision/doc/index.rst b/boards/arduino/nicla_vision/doc/index.rst
index 3dacfc5..fac12f2 100644
--- a/boards/arduino/nicla_vision/doc/index.rst
+++ b/boards/arduino/nicla_vision/doc/index.rst
@@ -137,7 +137,7 @@
 port to prepare it for flashing. Double click the ``RST`` button to put the
 board into the Arduino Bootloader mode. Then build and flash your application.
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/arduino/portenta_h7/doc/index.rst b/boards/arduino/portenta_h7/doc/index.rst
index 241c0c4..3ed6992 100644
--- a/boards/arduino/portenta_h7/doc/index.rst
+++ b/boards/arduino/portenta_h7/doc/index.rst
@@ -114,7 +114,7 @@
 the USB port to prepare it for flashing. Double tap the button to put the board
 into the Arduino Bootloader mode. Then build and flash your application.
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/arduino/zero/doc/index.rst b/boards/arduino/zero/doc/index.rst
index 46eb837..3ec0a0f 100644
--- a/boards/arduino/zero/doc/index.rst
+++ b/boards/arduino/zero/doc/index.rst
@@ -118,7 +118,7 @@
 Flashing
 ========
 
-#. Build the Zephyr kernel and the :ref:`hello_world` sample application:
+#. Build the Zephyr kernel and the :zephyr:code-sample:`hello_world` sample application:
 
    .. zephyr-app-commands::
       :zephyr-app: samples/hello_world
diff --git a/boards/arm/mps2/doc/mps2_an385.rst b/boards/arm/mps2/doc/mps2_an385.rst
index ffd8942..79f01dc 100644
--- a/boards/arm/mps2/doc/mps2_an385.rst
+++ b/boards/arm/mps2/doc/mps2_an385.rst
@@ -253,7 +253,7 @@
 Flashing an application to V2M MPS2
 -----------------------------------
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/arm/mps2/doc/mps2_an521.rst b/boards/arm/mps2/doc/mps2_an521.rst
index 7149902..33a4f4d 100644
--- a/boards/arm/mps2/doc/mps2_an521.rst
+++ b/boards/arm/mps2/doc/mps2_an521.rst
@@ -489,7 +489,7 @@
 - A Serial Port which is J10 on MPS2+ board
 
 Build applications as described above.
-Here is an example for the :ref:`hello_world` application built as
+Here is an example for the :zephyr:code-sample:`hello_world` application built as
 a secure-only application for CPU0.
 
 .. zephyr-app-commands::
diff --git a/boards/arm/mps3/doc/index.rst b/boards/arm/mps3/doc/index.rst
index 5309992..e618b9a 100644
--- a/boards/arm/mps3/doc/index.rst
+++ b/boards/arm/mps3/doc/index.rst
@@ -142,7 +142,7 @@
 -----------------------
 
 You can build applications in the usual way. Here is an example for
-the :ref:`hello_world` application.
+the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/arm/v2m_beetle/doc/index.rst b/boards/arm/v2m_beetle/doc/index.rst
index 7673e51..49df438 100644
--- a/boards/arm/v2m_beetle/doc/index.rst
+++ b/boards/arm/v2m_beetle/doc/index.rst
@@ -229,7 +229,7 @@
 -------------------------------------
 
 You can build applications in the usual way. Here is an example for
-the :ref:`hello_world` application.
+the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/arm/v2m_musca_b1/doc/index.rst b/boards/arm/v2m_musca_b1/doc/index.rst
index 0a7d41a..cb9aa61 100644
--- a/boards/arm/v2m_musca_b1/doc/index.rst
+++ b/boards/arm/v2m_musca_b1/doc/index.rst
@@ -308,7 +308,7 @@
 
 
 You can build applications in the usual way. Here is an example for
-the :ref:`hello_world` application.
+the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/arm/v2m_musca_s1/doc/index.rst b/boards/arm/v2m_musca_s1/doc/index.rst
index 7072ef7..8680689 100644
--- a/boards/arm/v2m_musca_s1/doc/index.rst
+++ b/boards/arm/v2m_musca_s1/doc/index.rst
@@ -301,7 +301,7 @@
 ----------------------------------
 
 You can build applications in the usual way. Here is an example for
-the :ref:`hello_world` application.
+the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -318,7 +318,7 @@
 Uploading an application to V2M Musca-S1
 ----------------------------------------
 
-To upload the :ref:`hello_world` application to the board, no extra steps are
+To upload the :zephyr:code-sample:`hello_world` application to the board, no extra steps are
 required. You can directly upload ``build/zephyr/zephyr.hex``, which is
 generated by Zephyr's build system.
 
diff --git a/boards/atmel/sam/sam4e_xpro/doc/index.rst b/boards/atmel/sam/sam4e_xpro/doc/index.rst
index 18d0836..b01e60c 100644
--- a/boards/atmel/sam/sam4e_xpro/doc/index.rst
+++ b/boards/atmel/sam/sam4e_xpro/doc/index.rst
@@ -122,7 +122,7 @@
 -------------
 
 #. Connect the SAM4E Xplained Pro board to your host computer using the USB
-   debug port. Then build and flash the :ref:`hello_world` application.
+   debug port. Then build and flash the :zephyr:code-sample:`hello_world` application.
 
    .. zephyr-app-commands::
       :zephyr-app: samples/hello_world
@@ -138,7 +138,7 @@
 #. Open the ``ERASE`` jumper.
 
 #. Connect the SAM4E Xplained Pro board to your host computer using the SoC
-   USB port. Then build and flash the :ref:`hello_world` application.
+   USB port. Then build and flash the :zephyr:code-sample:`hello_world` application.
 
    .. zephyr-app-commands::
       :zephyr-app: samples/hello_world
@@ -175,7 +175,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/atmel/sam/sam4l_ek/doc/index.rst b/boards/atmel/sam/sam4l_ek/doc/index.rst
index a28b072..f3e4e27 100644
--- a/boards/atmel/sam/sam4l_ek/doc/index.rst
+++ b/boards/atmel/sam/sam4l_ek/doc/index.rst
@@ -140,7 +140,7 @@
    - Stop bits: 1
 
 #. Connect the SAM4L-EK board to your host computer using the USB debug port.
-   Then build and flash the :ref:`hello_world` application.
+   Then build and flash the :zephyr:code-sample:`hello_world` application.
 
    .. zephyr-app-commands::
       :zephyr-app: samples/hello_world
@@ -153,7 +153,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/atmel/sam/sam4s_xplained/doc/index.rst b/boards/atmel/sam/sam4s_xplained/doc/index.rst
index 9c1b999..a5276bd 100644
--- a/boards/atmel/sam/sam4s_xplained/doc/index.rst
+++ b/boards/atmel/sam/sam4s_xplained/doc/index.rst
@@ -111,7 +111,7 @@
    accessible from your path.
 
 #. Connect the SAM4S Xplained board to your host computer using the USB debug
-   port. Then build and flash the :ref:`hello_world` application.
+   port. Then build and flash the :zephyr:code-sample:`hello_world` application.
 
    .. zephyr-app-commands::
       :zephyr-app: samples/hello_world
@@ -128,7 +128,7 @@
 #. Open the ``J25`` jumper.
 
 #. Connect the SAM4S Xplained board to your host computer using the SoC USB
-   port. Then build and flash the :ref:`hello_world` application.
+   port. Then build and flash the :zephyr:code-sample:`hello_world` application.
 
    .. zephyr-app-commands::
       :zephyr-app: samples/hello_world
@@ -167,7 +167,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/atmel/sam/sam_e70_xplained/doc/index.rst b/boards/atmel/sam/sam_e70_xplained/doc/index.rst
index bab33f5..67b90d4 100644
--- a/boards/atmel/sam/sam_e70_xplained/doc/index.rst
+++ b/boards/atmel/sam/sam_e70_xplained/doc/index.rst
@@ -141,7 +141,7 @@
    - Stop bits: 1
 
 #. Connect the SAM E70 Xplained board to your host computer using the
-   USB debug port. Then build and flash the :ref:`hello_world`
+   USB debug port. Then build and flash the :zephyr:code-sample:`hello_world`
    application.
 
    .. zephyr-app-commands::
@@ -171,7 +171,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/atmel/sam/sam_v71_xult/doc/index.rst b/boards/atmel/sam/sam_v71_xult/doc/index.rst
index e0b5fce..7ce56d5 100644
--- a/boards/atmel/sam/sam_v71_xult/doc/index.rst
+++ b/boards/atmel/sam/sam_v71_xult/doc/index.rst
@@ -144,7 +144,7 @@
    - Stop bits: 1
 
 #. Connect the SAM V71 Xplained Ultra board to your host computer using the
-   USB debug port. Then build and flash the :ref:`hello_world`
+   USB debug port. Then build and flash the :zephyr:code-sample:`hello_world`
    application.
 
    .. zephyr-app-commands::
@@ -174,7 +174,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/atmel/sam0/samd20_xpro/doc/index.rst b/boards/atmel/sam0/samd20_xpro/doc/index.rst
index b0dbff2..7b788cb 100644
--- a/boards/atmel/sam0/samd20_xpro/doc/index.rst
+++ b/boards/atmel/sam0/samd20_xpro/doc/index.rst
@@ -110,7 +110,7 @@
 Flashing
 ========
 
-#. Build the Zephyr kernel and the :ref:`hello_world` sample application:
+#. Build the Zephyr kernel and the :zephyr:code-sample:`hello_world` sample application:
 
    .. zephyr-app-commands::
       :zephyr-app: samples/hello_world
diff --git a/boards/atmel/sam0/samr21_xpro/doc/index.rst b/boards/atmel/sam0/samr21_xpro/doc/index.rst
index abb5cd9..91a4761 100644
--- a/boards/atmel/sam0/samr21_xpro/doc/index.rst
+++ b/boards/atmel/sam0/samr21_xpro/doc/index.rst
@@ -174,7 +174,7 @@
 Flashing
 ========
 
-#. Build the Zephyr kernel and the :ref:`hello_world` sample application:
+#. Build the Zephyr kernel and the :zephyr:code-sample:`hello_world` sample application:
 
    .. zephyr-app-commands::
       :zephyr-app: samples/hello_world
diff --git a/boards/bbc/microbit/doc/index.rst b/boards/bbc/microbit/doc/index.rst
index aa36d3d..c4d11f7 100644
--- a/boards/bbc/microbit/doc/index.rst
+++ b/boards/bbc/microbit/doc/index.rst
@@ -77,7 +77,7 @@
 Build and flash applications as usual (see :ref:`build_an_application` and
 :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 First, run your favorite terminal program to listen for output.
 
diff --git a/boards/bbc/microbit_v2/doc/index.rst b/boards/bbc/microbit_v2/doc/index.rst
index 7c94a3e..d906f13 100644
--- a/boards/bbc/microbit_v2/doc/index.rst
+++ b/boards/bbc/microbit_v2/doc/index.rst
@@ -71,7 +71,7 @@
 Build and flash applications as usual (see :ref:`build_an_application` and
 :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 First, run your favorite terminal program to listen for output.
 
diff --git a/boards/blues/swan_r5/doc/index.rst b/boards/blues/swan_r5/doc/index.rst
index a5d9dd6..6ee0625 100644
--- a/boards/blues/swan_r5/doc/index.rst
+++ b/boards/blues/swan_r5/doc/index.rst
@@ -198,7 +198,7 @@
 
 Connect Swan to your host computer using the USB port.
 Then build and flash an application. Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 Run a serial host program to connect with your Swan:
 
diff --git a/boards/bytesatwork/bytesensi_l/doc/index.rst b/boards/bytesatwork/bytesensi_l/doc/index.rst
index e50402f..9d16e74 100644
--- a/boards/bytesatwork/bytesensi_l/doc/index.rst
+++ b/boards/bytesatwork/bytesensi_l/doc/index.rst
@@ -134,7 +134,7 @@
 The byteSENSI-L board can be flashed with the SEGGER JLink programmer.
 
 You can build and flash applications in the usual way. Here is an example for
-the :ref:`hello_world` application.
+the :zephyr:code-sample:`hello_world` application.
 
    .. zephyr-app-commands::
       :zephyr-app: samples/hello_world
diff --git a/boards/circuitdojo/feather/doc/index.rst b/boards/circuitdojo/feather/doc/index.rst
index 998cfbcf..032b06d 100644
--- a/boards/circuitdojo/feather/doc/index.rst
+++ b/boards/circuitdojo/feather/doc/index.rst
@@ -111,7 +111,7 @@
 applications as usual (see :ref:`build_an_application` and
 :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 First, run your favorite terminal program to listen for output.
 
diff --git a/boards/contextualelectronics/abc/doc/index.rst b/boards/contextualelectronics/abc/doc/index.rst
index 15f9e52..dd8aa8a 100644
--- a/boards/contextualelectronics/abc/doc/index.rst
+++ b/boards/contextualelectronics/abc/doc/index.rst
@@ -93,7 +93,7 @@
 Flashing Zephyr onto the ``contextualelectronics_abc`` board requires
 an external programmer. The programmer is attached to the SWD header.
 
-Build the Zephyr kernel and the :ref:`hello_world` sample application.
+Build the Zephyr kernel and the :zephyr:code-sample:`hello_world` sample application.
 
    .. zephyr-app-commands::
       :zephyr-app: samples/hello_world
diff --git a/boards/cypress/cy8ckit_062_ble/doc/index.rst b/boards/cypress/cy8ckit_062_ble/doc/index.rst
index 155f94f..46940f0 100644
--- a/boards/cypress/cy8ckit_062_ble/doc/index.rst
+++ b/boards/cypress/cy8ckit_062_ble/doc/index.rst
@@ -154,7 +154,7 @@
 A watchdog timer is enabled by default. To disable it call Cy_WDT_Unlock() and
 Cy_WDT_Disable().
 
-#. Build the Zephyr kernel and the :ref:`hello_world` sample application:
+#. Build the Zephyr kernel and the :zephyr:code-sample:`hello_world` sample application:
 
    .. zephyr-app-commands::
       :zephyr-app: samples/hello_world
@@ -248,7 +248,7 @@
 revision (0.0.0) allows use of default connections.  The use of Arduino headers
 are only possible after rework the board and using the revision 1.0.0.
 
-#. Build the Zephyr kernel and the :ref:`hello_world` sample application for
+#. Build the Zephyr kernel and the :zephyr:code-sample:`hello_world` sample application for
    board revision 1.0.0:
 
    .. zephyr-app-commands::
diff --git a/boards/digilent/arty_a7/doc/index.rst b/boards/digilent/arty_a7/doc/index.rst
index 4284320..c6cad8d 100644
--- a/boards/digilent/arty_a7/doc/index.rst
+++ b/boards/digilent/arty_a7/doc/index.rst
@@ -159,7 +159,7 @@
 Flashing
 ========
 
-Here is an example for building and flashing the :ref:`hello_world` application
+Here is an example for building and flashing the :zephyr:code-sample:`hello_world` application
 for the Cortex-M1 reference design:
 
 .. zephyr-app-commands::
@@ -191,7 +191,7 @@
 Debugging
 =========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/digilent/zybo/doc/index.rst b/boards/digilent/zybo/doc/index.rst
index f8e3857..7b5bf38 100644
--- a/boards/digilent/zybo/doc/index.rst
+++ b/boards/digilent/zybo/doc/index.rst
@@ -77,7 +77,7 @@
 Flashing
 ========
 
-Here is an example for running the :ref:`hello_world` application via JTAG.
+Here is an example for running the :zephyr:code-sample:`hello_world` application via JTAG.
 
 Ensure the board is configured for JTAG boot, open a serial terminal, turn on/reset the board (press
 the ``PS-SRST`` button), and initialize the Zynq-7000 series SoC by uploading and running the U-Boot
@@ -97,7 +97,7 @@
    *** Booting Zephyr OS vx.xx.x-xxx-gxxxxxxxxxxxx ***
    Hello World! zybo
 
-Another option is to load and run the :ref:`hello_world` application via U-Boot. Copy
+Another option is to load and run the :zephyr:code-sample:`hello_world` application via U-Boot. Copy
 ``u-boot/spl/boot.bin``, ``u-boot/u-boot.img``, and ``zephyr/zephyr.bin`` to a FAT32 formatted
 microSD card, insert the card in the ``SD MICRO`` slot on the Zybo board, ensure the board is
 configured for ``SD`` boot, and turn on the board.
@@ -116,7 +116,7 @@
 Debugging
 =========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 Ensure the board is configured for JTAG boot, open a serial terminal, turn on/reset the board (press
 the ``PS-SRST`` button), and initialize the Zynq-7000 series SoC by uploading and running the U-Boot
diff --git a/boards/dragino/lsn50/doc/index.rst b/boards/dragino/lsn50/doc/index.rst
index b3d14f9..4a29c56 100644
--- a/boards/dragino/lsn50/doc/index.rst
+++ b/boards/dragino/lsn50/doc/index.rst
@@ -149,7 +149,7 @@
 Flashing an application to Dragino LSN50
 ----------------------------------------
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 Connect the Dragino LSN50 to a STLinkV2 to your host computer using the USB port, then
 run a serial host program to connect with your board. For example:
@@ -175,7 +175,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/dragino/nbsn95/doc/index.rst b/boards/dragino/nbsn95/doc/index.rst
index 09a8b91..27e32b7 100644
--- a/boards/dragino/nbsn95/doc/index.rst
+++ b/boards/dragino/nbsn95/doc/index.rst
@@ -148,7 +148,7 @@
 Flashing an application to Dragino NBSN95
 -----------------------------------------
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 Connect the Dragino NBSN95 to a STLinkV2 to your host computer using the USB port, then
 run a serial host program to connect with your board. For example:
@@ -174,7 +174,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/electronut/nrf52840_blip/doc/index.rst b/boards/electronut/nrf52840_blip/doc/index.rst
index 9f78cee..67a736b 100644
--- a/boards/electronut/nrf52840_blip/doc/index.rst
+++ b/boards/electronut/nrf52840_blip/doc/index.rst
@@ -141,7 +141,7 @@
 Applications are flashed and run as usual (see :ref:`build_an_application` and
 :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 First, run your favorite terminal program to listen for output.
 
diff --git a/boards/electronut/nrf52840_papyr/doc/nrf52840_papyr.rst b/boards/electronut/nrf52840_papyr/doc/nrf52840_papyr.rst
index 7890cd1..814ef88 100644
--- a/boards/electronut/nrf52840_papyr/doc/nrf52840_papyr.rst
+++ b/boards/electronut/nrf52840_papyr/doc/nrf52840_papyr.rst
@@ -151,7 +151,7 @@
 Applications are flashed and run as usual (see :ref:`build_an_application` and
 :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 First, run your favorite terminal program to listen for output.
 
diff --git a/boards/espressif/esp32_devkitc_wroom/doc/index.rst b/boards/espressif/esp32_devkitc_wroom/doc/index.rst
index f38470e..68955f9 100644
--- a/boards/espressif/esp32_devkitc_wroom/doc/index.rst
+++ b/boards/espressif/esp32_devkitc_wroom/doc/index.rst
@@ -213,7 +213,7 @@
    :goals: build
 
 The usual ``flash`` target will work with the ``esp32_devkitc_wroom`` board
-configuration. Here is an example for the :ref:`hello_world`
+configuration. Here is an example for the :zephyr:code-sample:`hello_world`
 application.
 
 .. zephyr-app-commands::
@@ -264,14 +264,14 @@
 
 Further documentation can be obtained from the SoC vendor in `JTAG debugging for ESP32`_.
 
-Here is an example for building the :ref:`hello_world` application.
+Here is an example for building the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
    :board: esp32_devkitc_wroom/esp32/procpu
    :goals: build flash
 
-You can debug an application in the usual way. Here is an example for the :ref:`hello_world` application.
+You can debug an application in the usual way. Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/espressif/esp32_devkitc_wrover/doc/index.rst b/boards/espressif/esp32_devkitc_wrover/doc/index.rst
index 24a2207..81c75c5 100644
--- a/boards/espressif/esp32_devkitc_wrover/doc/index.rst
+++ b/boards/espressif/esp32_devkitc_wrover/doc/index.rst
@@ -213,7 +213,7 @@
    :goals: build
 
 The usual ``flash`` target will work with the ``esp32_devkitc_wrover`` board
-configuration. Here is an example for the :ref:`hello_world`
+configuration. Here is an example for the :zephyr:code-sample:`hello_world`
 application.
 
 .. zephyr-app-commands::
@@ -264,14 +264,14 @@
 
 Further documentation can be obtained from the SoC vendor in `JTAG debugging for ESP32`_.
 
-Here is an example for building the :ref:`hello_world` application.
+Here is an example for building the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
    :board: esp32_devkitc_wrover/esp32/procpu
    :goals: build flash
 
-You can debug an application in the usual way. Here is an example for the :ref:`hello_world` application.
+You can debug an application in the usual way. Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/espressif/esp32_ethernet_kit/doc/index.rst b/boards/espressif/esp32_ethernet_kit/doc/index.rst
index a23d94d..4437e47 100644
--- a/boards/espressif/esp32_ethernet_kit/doc/index.rst
+++ b/boards/espressif/esp32_ethernet_kit/doc/index.rst
@@ -530,7 +530,7 @@
    :goals: build
 
 The usual ``flash`` target will work with the ``esp32_ethernet_kit`` board
-configuration. Here is an example for the :ref:`hello_world`
+configuration. Here is an example for the :zephyr:code-sample:`hello_world`
 application.
 
 .. zephyr-app-commands::
@@ -563,7 +563,7 @@
 ``-DOPENOCD=<path/to/bin/openocd> -DOPENOCD_DEFAULT_PATH=<path/to/openocd/share/openocd/scripts>``
 parameter when building.
 
-Here is an example for building the :ref:`hello_world` application.
+Here is an example for building the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -571,7 +571,7 @@
    :goals: build flash
    :gen-args: -DOPENOCD=<path/to/bin/openocd> -DOPENOCD_DEFAULT_PATH=<path/to/openocd/share/openocd/scripts>
 
-You can debug an application in the usual way. Here is an example for the :ref:`hello_world` application.
+You can debug an application in the usual way. Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/espressif/esp32c3_devkitc/doc/index.rst b/boards/espressif/esp32c3_devkitc/doc/index.rst
index f000b95..97ce7f1 100644
--- a/boards/espressif/esp32c3_devkitc/doc/index.rst
+++ b/boards/espressif/esp32c3_devkitc/doc/index.rst
@@ -195,7 +195,7 @@
    :goals: build
 
 The usual ``flash`` target will work with the ``esp32c3_devkitc`` board
-configuration. Here is an example for the :ref:`hello_world`
+configuration. Here is an example for the :zephyr:code-sample:`hello_world`
 application.
 
 .. zephyr-app-commands::
@@ -228,7 +228,7 @@
 ``-DOPENOCD=<path/to/bin/openocd> -DOPENOCD_DEFAULT_PATH=<path/to/openocd/share/openocd/scripts>``
 parameter when building.
 
-Here is an example for building the :ref:`hello_world` application.
+Here is an example for building the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -236,7 +236,7 @@
    :goals: build flash
    :gen-args: -DOPENOCD=<path/to/bin/openocd> -DOPENOCD_DEFAULT_PATH=<path/to/openocd/share/openocd/scripts>
 
-You can debug an application in the usual way. Here is an example for the :ref:`hello_world` application.
+You can debug an application in the usual way. Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/espressif/esp32c3_devkitm/doc/index.rst b/boards/espressif/esp32c3_devkitm/doc/index.rst
index 0100950..aed6710 100644
--- a/boards/espressif/esp32c3_devkitm/doc/index.rst
+++ b/boards/espressif/esp32c3_devkitm/doc/index.rst
@@ -195,7 +195,7 @@
    :goals: build
 
 The usual ``flash`` target will work with the ``esp32c3_devkitm`` board
-configuration. Here is an example for the :ref:`hello_world`
+configuration. Here is an example for the :zephyr:code-sample:`hello_world`
 application.
 
 .. zephyr-app-commands::
@@ -228,7 +228,7 @@
 ``-DOPENOCD=<path/to/bin/openocd> -DOPENOCD_DEFAULT_PATH=<path/to/openocd/share/openocd/scripts>``
 parameter when building.
 
-Here is an example for building the :ref:`hello_world` application.
+Here is an example for building the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -236,7 +236,7 @@
    :goals: build flash
    :gen-args: -DOPENOCD=<path/to/bin/openocd> -DOPENOCD_DEFAULT_PATH=<path/to/openocd/share/openocd/scripts>
 
-You can debug an application in the usual way. Here is an example for the :ref:`hello_world` application.
+You can debug an application in the usual way. Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/espressif/esp32c3_rust/doc/index.rst b/boards/espressif/esp32c3_rust/doc/index.rst
index fc049ef..7b80d30 100644
--- a/boards/espressif/esp32c3_rust/doc/index.rst
+++ b/boards/espressif/esp32c3_rust/doc/index.rst
@@ -240,7 +240,7 @@
    :goals: build
 
 The usual ``flash`` target will work with the ``esp32c3_rust`` board
-configuration. Here is an example for the :ref:`hello_world`
+configuration. Here is an example for the :zephyr:code-sample:`hello_world`
 application.
 
 .. zephyr-app-commands::
@@ -273,7 +273,7 @@
 ``-DOPENOCD=<path/to/bin/openocd> -DOPENOCD_DEFAULT_PATH=<path/to/openocd/share/openocd/scripts>``
 parameter when building.
 
-Here is an example for building the :ref:`hello_world` application.
+Here is an example for building the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -281,7 +281,7 @@
    :goals: build flash
    :gen-args: -DOPENOCD=<path/to/bin/openocd> -DOPENOCD_DEFAULT_PATH=<path/to/openocd/share/openocd/scripts>
 
-You can debug an application in the usual way. Here is an example for the :ref:`hello_world` application.
+You can debug an application in the usual way. Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/espressif/esp32c6_devkitc/doc/index.rst b/boards/espressif/esp32c6_devkitc/doc/index.rst
index 9383ed6..7b85691 100644
--- a/boards/espressif/esp32c6_devkitc/doc/index.rst
+++ b/boards/espressif/esp32c6_devkitc/doc/index.rst
@@ -229,7 +229,7 @@
    :goals: build
 
 The usual ``flash`` target will work with the ``esp32c6_devkitc`` board
-configuration. Here is an example for the :ref:`hello_world`
+configuration. Here is an example for the :zephyr:code-sample:`hello_world`
 application.
 
 .. zephyr-app-commands::
@@ -262,7 +262,7 @@
 ``-DOPENOCD=<path/to/bin/openocd> -DOPENOCD_DEFAULT_PATH=<path/to/openocd/share/openocd/scripts>``
 parameter when building.
 
-Here is an example for building the :ref:`hello_world` application.
+Here is an example for building the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -270,7 +270,7 @@
    :goals: build flash
    :gen-args: -DOPENOCD=<path/to/bin/openocd> -DOPENOCD_DEFAULT_PATH=<path/to/openocd/share/openocd/scripts>
 
-You can debug an application in the usual way. Here is an example for the :ref:`hello_world` application.
+You can debug an application in the usual way. Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/espressif/esp32s2_devkitc/doc/index.rst b/boards/espressif/esp32s2_devkitc/doc/index.rst
index 4d7d400..9e1bb15 100644
--- a/boards/espressif/esp32s2_devkitc/doc/index.rst
+++ b/boards/espressif/esp32s2_devkitc/doc/index.rst
@@ -192,7 +192,7 @@
    :goals: build
 
 The usual ``flash`` target will work with the ``esp32s2_devkitc`` board
-configuration. Here is an example for the :ref:`hello_world`
+configuration. Here is an example for the :zephyr:code-sample:`hello_world`
 application.
 
 .. zephyr-app-commands::
@@ -235,14 +235,14 @@
 
 Further documentation can be obtained from the SoC vendor in `JTAG debugging for ESP32-S2`_.
 
-Here is an example for building the :ref:`hello_world` application.
+Here is an example for building the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
    :board: esp32s2_devkitc
    :goals: build flash
 
-You can debug an application in the usual way. Here is an example for the :ref:`hello_world` application.
+You can debug an application in the usual way. Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/espressif/esp32s2_saola/doc/index.rst b/boards/espressif/esp32s2_saola/doc/index.rst
index 05db30b..dba54f9 100644
--- a/boards/espressif/esp32s2_saola/doc/index.rst
+++ b/boards/espressif/esp32s2_saola/doc/index.rst
@@ -192,7 +192,7 @@
    :goals: build
 
 The usual ``flash`` target will work with the ``esp32s2_saola`` board
-configuration. Here is an example for the :ref:`hello_world`
+configuration. Here is an example for the :zephyr:code-sample:`hello_world`
 application.
 
 .. zephyr-app-commands::
@@ -235,14 +235,14 @@
 
 Further documentation can be obtained from the SoC vendor in `JTAG debugging for ESP32-S2`_.
 
-Here is an example for building the :ref:`hello_world` application.
+Here is an example for building the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
    :board: esp32s2_saola
    :goals: build flash
 
-You can debug an application in the usual way. Here is an example for the :ref:`hello_world` application.
+You can debug an application in the usual way. Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/espressif/esp32s3_devkitc/doc/index.rst b/boards/espressif/esp32s3_devkitc/doc/index.rst
index f026ba3..984a714 100644
--- a/boards/espressif/esp32s3_devkitc/doc/index.rst
+++ b/boards/espressif/esp32s3_devkitc/doc/index.rst
@@ -231,7 +231,7 @@
    :goals: build
 
 The usual ``flash`` target will work with the ``esp32s3_devkitc`` board
-configuration. Here is an example for the :ref:`hello_world`
+configuration. Here is an example for the :zephyr:code-sample:`hello_world`
 application.
 
 .. zephyr-app-commands::
@@ -262,14 +262,14 @@
 
 Further documentation can be obtained from the SoC vendor in `JTAG debugging for ESP32-S3`_.
 
-Here is an example for building the :ref:`hello_world` application.
+Here is an example for building the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
    :board: esp32s3_devkitc/esp32s3/procpu
    :goals: build flash
 
-You can debug an application in the usual way. Here is an example for the :ref:`hello_world` application.
+You can debug an application in the usual way. Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/espressif/esp32s3_devkitm/doc/index.rst b/boards/espressif/esp32s3_devkitm/doc/index.rst
index 4cc05c4..b1e7976 100644
--- a/boards/espressif/esp32s3_devkitm/doc/index.rst
+++ b/boards/espressif/esp32s3_devkitm/doc/index.rst
@@ -231,7 +231,7 @@
    :goals: build
 
 The usual ``flash`` target will work with the ``esp32s3_devkitm`` board
-configuration. Here is an example for the :ref:`hello_world`
+configuration. Here is an example for the :zephyr:code-sample:`hello_world`
 application.
 
 .. zephyr-app-commands::
@@ -262,14 +262,14 @@
 
 Further documentation can be obtained from the SoC vendor in `JTAG debugging for ESP32-S3`_.
 
-Here is an example for building the :ref:`hello_world` application.
+Here is an example for building the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
    :board: esp32s3_devkitm/esp32s3/procpu
    :goals: build flash
 
-You can debug an application in the usual way. Here is an example for the :ref:`hello_world` application.
+You can debug an application in the usual way. Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/espressif/esp8684_devkitm/doc/index.rst b/boards/espressif/esp8684_devkitm/doc/index.rst
index e3d2b93..5dd05ab 100644
--- a/boards/espressif/esp8684_devkitm/doc/index.rst
+++ b/boards/espressif/esp8684_devkitm/doc/index.rst
@@ -187,7 +187,7 @@
    :goals: build
 
 The usual ``flash`` target will work with the ``esp8684_devkitm`` board
-configuration. Here is an example for the :ref:`hello_world`
+configuration. Here is an example for the :zephyr:code-sample:`hello_world`
 application.
 
 .. zephyr-app-commands::
@@ -220,7 +220,7 @@
 ``-DOPENOCD=<path/to/bin/openocd> -DOPENOCD_DEFAULT_PATH=<path/to/openocd/share/openocd/scripts>``
 parameter when building.
 
-Here is an example for building the :ref:`hello_world` application.
+Here is an example for building the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -228,7 +228,7 @@
    :goals: build flash
    :gen-args: -DOPENOCD=<path/to/bin/openocd> -DOPENOCD_DEFAULT_PATH=<path/to/openocd/share/openocd/scripts>
 
-You can debug an application in the usual way. Here is an example for the :ref:`hello_world` application.
+You can debug an application in the usual way. Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/espressif/esp_wrover_kit/doc/index.rst b/boards/espressif/esp_wrover_kit/doc/index.rst
index 67991e0..0bef9a9 100644
--- a/boards/espressif/esp_wrover_kit/doc/index.rst
+++ b/boards/espressif/esp_wrover_kit/doc/index.rst
@@ -598,7 +598,7 @@
    :goals: build
 
 The usual ``flash`` target will work with the ``esp_wrover_kit`` board
-configuration. Here is an example for the :ref:`hello_world`
+configuration. Here is an example for the :zephyr:code-sample:`hello_world`
 application.
 
 .. zephyr-app-commands::
@@ -634,7 +634,7 @@
 switch, next to similar headers for SPI and UART.  See
 `ESP-WROVER-32 V3 Getting Started Guide`_ for details.
 
-Here is an example for building the :ref:`hello_world` application.
+Here is an example for building the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -642,7 +642,7 @@
    :goals: build flash
    :gen-args: -DOPENOCD=<path/to/bin/openocd> -DOPENOCD_DEFAULT_PATH=<path/to/openocd/share/openocd/scripts>
 
-You can debug an application in the usual way. Here is an example for the :ref:`hello_world` application.
+You can debug an application in the usual way. Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/ezurio/bl5340_dvk/doc/index.rst b/boards/ezurio/bl5340_dvk/doc/index.rst
index 7ec6975..62a7de8 100644
--- a/boards/ezurio/bl5340_dvk/doc/index.rst
+++ b/boards/ezurio/bl5340_dvk/doc/index.rst
@@ -379,7 +379,7 @@
    Further information on how to install the nRF Command Line Tools can
    be found in :ref:`nordic_segger_flashing`.
 
-Here is an example for the :ref:`hello_world` application running on the
+Here is an example for the :zephyr:code-sample:`hello_world` application running on the
 BL5340's application core.
 
 First, run your favorite terminal program to listen for output.
diff --git a/boards/ezurio/bl652_dvk/doc/bl652_dvk.rst b/boards/ezurio/bl652_dvk/doc/bl652_dvk.rst
index c7ed935..aaae4b9 100644
--- a/boards/ezurio/bl652_dvk/doc/bl652_dvk.rst
+++ b/boards/ezurio/bl652_dvk/doc/bl652_dvk.rst
@@ -214,7 +214,7 @@
 applications as usual (see :ref:`build_an_application` and
 :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 First, run your favorite terminal program to listen for output.
 
diff --git a/boards/ezurio/bl653_dvk/doc/bl653_dvk.rst b/boards/ezurio/bl653_dvk/doc/bl653_dvk.rst
index 4011984..48c252b 100644
--- a/boards/ezurio/bl653_dvk/doc/bl653_dvk.rst
+++ b/boards/ezurio/bl653_dvk/doc/bl653_dvk.rst
@@ -120,7 +120,7 @@
 applications as usual (see :ref:`build_an_application` and
 :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 First, run your favorite terminal program to listen for output.
 
diff --git a/boards/ezurio/bl654_dvk/doc/bl654_dvk.rst b/boards/ezurio/bl654_dvk/doc/bl654_dvk.rst
index 2affaca..d262a9a 100644
--- a/boards/ezurio/bl654_dvk/doc/bl654_dvk.rst
+++ b/boards/ezurio/bl654_dvk/doc/bl654_dvk.rst
@@ -131,7 +131,7 @@
 applications as usual (see :ref:`build_an_application` and
 :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 First, run your favorite terminal program to listen for output.
 
diff --git a/boards/ezurio/bl654_sensor_board/doc/bl654_sensor_board.rst b/boards/ezurio/bl654_sensor_board/doc/bl654_sensor_board.rst
index bfea48d..32036e3 100644
--- a/boards/ezurio/bl654_sensor_board/doc/bl654_sensor_board.rst
+++ b/boards/ezurio/bl654_sensor_board/doc/bl654_sensor_board.rst
@@ -145,7 +145,7 @@
 details). If using a Ezurio USB-SWD Programmer Board, see the
 `pyOCD website`_ to find details about the software and how to install it.
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 First, run your favorite terminal program to listen for output - note that an
 external UART is required to be connected to the BL654 sensor board's UART, if
diff --git a/boards/ezurio/bt510/doc/bt510.rst b/boards/ezurio/bt510/doc/bt510.rst
index ec0890c..bcdaf27 100644
--- a/boards/ezurio/bt510/doc/bt510.rst
+++ b/boards/ezurio/bt510/doc/bt510.rst
@@ -187,7 +187,7 @@
 
    $ ninja flash
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 First, run your favorite terminal program to listen for output.
 
diff --git a/boards/ezurio/bt610/doc/bt610.rst b/boards/ezurio/bt610/doc/bt610.rst
index 6c72804..528186e 100644
--- a/boards/ezurio/bt610/doc/bt610.rst
+++ b/boards/ezurio/bt610/doc/bt610.rst
@@ -545,7 +545,7 @@
 applications as usual (see :ref:`build_an_application` and
 :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 First, run your favorite terminal program to listen for output.
 
diff --git a/boards/ezurio/mg100/doc/index.rst b/boards/ezurio/mg100/doc/index.rst
index 29274d9..86b92c5 100644
--- a/boards/ezurio/mg100/doc/index.rst
+++ b/boards/ezurio/mg100/doc/index.rst
@@ -174,7 +174,7 @@
 applications as usual (see :ref:`build_an_application` and
 :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 First, run your favorite terminal program to listen for output.
 
diff --git a/boards/ezurio/pinnacle_100_dvk/doc/index.rst b/boards/ezurio/pinnacle_100_dvk/doc/index.rst
index de8735f..7b63ada 100644
--- a/boards/ezurio/pinnacle_100_dvk/doc/index.rst
+++ b/boards/ezurio/pinnacle_100_dvk/doc/index.rst
@@ -144,7 +144,7 @@
 applications as usual (see :ref:`build_an_application` and
 :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 First, run your favorite terminal program to listen for output.
 
diff --git a/boards/ezurio/rm1xx_dvk/doc/index.rst b/boards/ezurio/rm1xx_dvk/doc/index.rst
index f530c9b..bd57e8f 100644
--- a/boards/ezurio/rm1xx_dvk/doc/index.rst
+++ b/boards/ezurio/rm1xx_dvk/doc/index.rst
@@ -143,7 +143,7 @@
 applications as usual (see :ref:`build_an_application` and
 :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 First, run your favorite terminal program to listen for output.
 
diff --git a/boards/fanke/fk7b0m1_vbt6/doc/index.rst b/boards/fanke/fk7b0m1_vbt6/doc/index.rst
index dfabfd5..19b3465 100644
--- a/boards/fanke/fk7b0m1_vbt6/doc/index.rst
+++ b/boards/fanke/fk7b0m1_vbt6/doc/index.rst
@@ -145,7 +145,7 @@
 interface. Next, connect the ST-Link to your host computer via a USB port.
 Once this setup is complete, you can proceed to build and flash your application to the board
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/franzininho/esp32s2_franzininho/doc/index.rst b/boards/franzininho/esp32s2_franzininho/doc/index.rst
index b2d1a8f..efa47c9 100644
--- a/boards/franzininho/esp32s2_franzininho/doc/index.rst
+++ b/boards/franzininho/esp32s2_franzininho/doc/index.rst
@@ -148,7 +148,7 @@
    :goals: build
 
 The usual ``flash`` target will work with the ``esp32s2_franzininho`` board
-configuration. Here is an example for the :ref:`hello_world`
+configuration. Here is an example for the :zephyr:code-sample:`hello_world`
 application.
 
 .. zephyr-app-commands::
diff --git a/boards/gd/gd32a503v_eval/doc/index.rst b/boards/gd/gd32a503v_eval/doc/index.rst
index b926a26..bd9170b 100644
--- a/boards/gd/gd32a503v_eval/doc/index.rst
+++ b/boards/gd/gd32a503v_eval/doc/index.rst
@@ -119,7 +119,7 @@
 allow flash programming and debug over USB. There are also program and debug
 headers J2 and J100 that can be used with any ARM compatible tools.
 
-#. Build the Zephyr kernel and the :ref:`hello_world` sample application:
+#. Build the Zephyr kernel and the :zephyr:code-sample:`hello_world` sample application:
 
    .. zephyr-app-commands::
       :zephyr-app: samples/hello_world
@@ -168,7 +168,7 @@
 should install `GD32 ISP Console`_ software at some Linux path.  The recommended
 is :code:`$HOME/.local/bin`.
 
-#. Build the Zephyr kernel and the :ref:`hello_world` sample application:
+#. Build the Zephyr kernel and the :zephyr:code-sample:`hello_world` sample application:
 
    .. zephyr-app-commands::
       :zephyr-app: samples/hello_world
diff --git a/boards/gd/gd32e103v_eval/doc/index.rst b/boards/gd/gd32e103v_eval/doc/index.rst
index 3d90587..f53d0b1 100644
--- a/boards/gd/gd32e103v_eval/doc/index.rst
+++ b/boards/gd/gd32e103v_eval/doc/index.rst
@@ -111,7 +111,7 @@
 allow flash programming and debug over USB. There are also program and debug
 headers J1 and J100 that can be used with any ARM compatible tools.
 
-#. Build the Zephyr kernel and the :ref:`hello_world` sample application:
+#. Build the Zephyr kernel and the :zephyr:code-sample:`hello_world` sample application:
 
    .. zephyr-app-commands::
       :zephyr-app: samples/hello_world
@@ -160,7 +160,7 @@
 should install `GD32 ISP Console`_ software at some Linux path.  The recommended
 is :code:`$HOME/.local/bin`.
 
-#. Build the Zephyr kernel and the :ref:`hello_world` sample application:
+#. Build the Zephyr kernel and the :zephyr:code-sample:`hello_world` sample application:
 
    .. zephyr-app-commands::
       :zephyr-app: samples/hello_world
diff --git a/boards/gd/gd32e507v_start/doc/index.rst b/boards/gd/gd32e507v_start/doc/index.rst
index 097c5a5..902b4a2 100644
--- a/boards/gd/gd32e507v_start/doc/index.rst
+++ b/boards/gd/gd32e507v_start/doc/index.rst
@@ -94,7 +94,7 @@
 J-Link can also be used to program the board using the SWD interface exposed in
 the JP1 header.
 
-#. Build the Zephyr kernel and the :ref:`hello_world` sample application:
+#. Build the Zephyr kernel and the :zephyr:code-sample:`hello_world` sample application:
 
    .. zephyr-app-commands::
       :zephyr-app: samples/hello_world
diff --git a/boards/gd/gd32e507z_eval/doc/index.rst b/boards/gd/gd32e507z_eval/doc/index.rst
index c3484d8..edaac63 100644
--- a/boards/gd/gd32e507z_eval/doc/index.rst
+++ b/boards/gd/gd32e507z_eval/doc/index.rst
@@ -102,7 +102,7 @@
 J-Link can also be used to program the board using the JTAG interface exposed in
 the JP2 header.
 
-#. Build the Zephyr kernel and the :ref:`hello_world` sample application:
+#. Build the Zephyr kernel and the :zephyr:code-sample:`hello_world` sample application:
 
    .. zephyr-app-commands::
       :zephyr-app: samples/hello_world
diff --git a/boards/gd/gd32f350r_eval/doc/index.rst b/boards/gd/gd32f350r_eval/doc/index.rst
index 8a2317d..d5dc24f 100644
--- a/boards/gd/gd32f350r_eval/doc/index.rst
+++ b/boards/gd/gd32f350r_eval/doc/index.rst
@@ -87,7 +87,7 @@
 allows flash programming and debugging over USB. There is also a SWD header
 (J3) which can be used with tools like Segger J-Link.
 
-#. Build the Zephyr kernel and the :ref:`hello_world` sample application:
+#. Build the Zephyr kernel and the :zephyr:code-sample:`hello_world` sample application:
 
    .. zephyr-app-commands::
       :zephyr-app: samples/hello_world
diff --git a/boards/gd/gd32f403z_eval/doc/index.rst b/boards/gd/gd32f403z_eval/doc/index.rst
index 4ea432c..c5c97fd 100644
--- a/boards/gd/gd32f403z_eval/doc/index.rst
+++ b/boards/gd/gd32f403z_eval/doc/index.rst
@@ -114,7 +114,7 @@
 allow flash programming and debug over USB. There are also program and debug
 headers J1 and J100 that can be used with any ARM compatible tools.
 
-#. Build the Zephyr kernel and the :ref:`hello_world` sample application:
+#. Build the Zephyr kernel and the :zephyr:code-sample:`hello_world` sample application:
 
    .. zephyr-app-commands::
       :zephyr-app: samples/hello_world
@@ -163,7 +163,7 @@
 should install `GD32 ISP Console`_ software at some Linux path.  The recommended
 is :code:`$HOME/.local/bin`.
 
-#. Build the Zephyr kernel and the :ref:`hello_world` sample application:
+#. Build the Zephyr kernel and the :zephyr:code-sample:`hello_world` sample application:
 
    .. zephyr-app-commands::
       :zephyr-app: samples/hello_world
diff --git a/boards/gd/gd32f407v_start/doc/index.rst b/boards/gd/gd32f407v_start/doc/index.rst
index cd67921..a59243d 100644
--- a/boards/gd/gd32f407v_start/doc/index.rst
+++ b/boards/gd/gd32f407v_start/doc/index.rst
@@ -96,7 +96,7 @@
 Also, J-Link can be used to program the board via the SWD interface
 (PA13/SWDIO and PA14/SWCLK in the JP6 header).
 
-#. Build the Zephyr kernel and the :ref:`hello_world` sample application:
+#. Build the Zephyr kernel and the :zephyr:code-sample:`hello_world` sample application:
 
    .. zephyr-app-commands::
       :zephyr-app: samples/hello_world
diff --git a/boards/gd/gd32f450i_eval/doc/index.rst b/boards/gd/gd32f450i_eval/doc/index.rst
index 59e9d25..e01c395 100644
--- a/boards/gd/gd32f450i_eval/doc/index.rst
+++ b/boards/gd/gd32f450i_eval/doc/index.rst
@@ -112,7 +112,7 @@
 allows flash programming and debugging over USB. There is also a JTAG header
 (J1) which can be used with tools like Segger J-Link.
 
-#. Build the Zephyr kernel and the :ref:`hello_world` sample application:
+#. Build the Zephyr kernel and the :zephyr:code-sample:`hello_world` sample application:
 
    .. zephyr-app-commands::
       :zephyr-app: samples/hello_world
diff --git a/boards/gd/gd32f450v_start/doc/index.rst b/boards/gd/gd32f450v_start/doc/index.rst
index e45f05a..0b1a781 100644
--- a/boards/gd/gd32f450v_start/doc/index.rst
+++ b/boards/gd/gd32f450v_start/doc/index.rst
@@ -89,7 +89,7 @@
 allows flash programming and debugging over USB. There is also a SWD header
 (JP100) which can be used with tools like Segger J-Link.
 
-#. Build the Zephyr kernel and the :ref:`hello_world` sample application:
+#. Build the Zephyr kernel and the :zephyr:code-sample:`hello_world` sample application:
 
    .. zephyr-app-commands::
       :zephyr-app: samples/hello_world
diff --git a/boards/gd/gd32f450z_eval/doc/index.rst b/boards/gd/gd32f450z_eval/doc/index.rst
index 0e31f26..cdc4f8f 100644
--- a/boards/gd/gd32f450z_eval/doc/index.rst
+++ b/boards/gd/gd32f450z_eval/doc/index.rst
@@ -107,7 +107,7 @@
 allows flash programming and debugging over USB. There is also a JTAG header
 (J1) which can be used with tools like Segger J-Link.
 
-#. Build the Zephyr kernel and the :ref:`hello_world` sample application:
+#. Build the Zephyr kernel and the :zephyr:code-sample:`hello_world` sample application:
 
    .. zephyr-app-commands::
       :zephyr-app: samples/hello_world
diff --git a/boards/gd/gd32f470i_eval/doc/index.rst b/boards/gd/gd32f470i_eval/doc/index.rst
index 627dc1f..75e33ea 100644
--- a/boards/gd/gd32f470i_eval/doc/index.rst
+++ b/boards/gd/gd32f470i_eval/doc/index.rst
@@ -111,7 +111,7 @@
 allows flash programming and debugging over USB. There is also a JTAG header
 (J1) which can be used with tools like Segger J-Link.
 
-#. Build the Zephyr kernel and the :ref:`hello_world` sample application:
+#. Build the Zephyr kernel and the :zephyr:code-sample:`hello_world` sample application:
 
    .. zephyr-app-commands::
       :zephyr-app: samples/hello_world
diff --git a/boards/gd/gd32l233r_eval/doc/index.rst b/boards/gd/gd32l233r_eval/doc/index.rst
index 8b5a085..884978f 100644
--- a/boards/gd/gd32l233r_eval/doc/index.rst
+++ b/boards/gd/gd32l233r_eval/doc/index.rst
@@ -88,7 +88,7 @@
 allows flash programming and debugging over USB. There is also a SWD header
 which can be used with tools like Segger J-Link(latest version required).
 
-#. Build the Zephyr kernel and the :ref:`hello_world` sample application:
+#. Build the Zephyr kernel and the :zephyr:code-sample:`hello_world` sample application:
 
    .. zephyr-app-commands::
       :zephyr-app: samples/hello_world
diff --git a/boards/gd/gd32vf103c_starter/doc/index.rst b/boards/gd/gd32vf103c_starter/doc/index.rst
index aee1ea6..29a428c 100644
--- a/boards/gd/gd32vf103c_starter/doc/index.rst
+++ b/boards/gd/gd32vf103c_starter/doc/index.rst
@@ -83,7 +83,7 @@
 allows flash programming and debugging over USB. There is also a JTAG header
 (JP1) which can be used with tools like Segger J-Link.
 
-#. Build the Zephyr kernel and the :ref:`hello_world` sample application:
+#. Build the Zephyr kernel and the :zephyr:code-sample:`hello_world` sample application:
 
    .. zephyr-app-commands::
       :zephyr-app: samples/hello_world
diff --git a/boards/gd/gd32vf103v_eval/doc/index.rst b/boards/gd/gd32vf103v_eval/doc/index.rst
index 42af6d7..5aa8e83 100644
--- a/boards/gd/gd32vf103v_eval/doc/index.rst
+++ b/boards/gd/gd32vf103v_eval/doc/index.rst
@@ -93,7 +93,7 @@
 allows flash programming and debugging over USB. There is also a JTAG header
 (JP1) which can be used with tools like Segger J-Link.
 
-#. Build the Zephyr kernel and the :ref:`hello_world` sample application:
+#. Build the Zephyr kernel and the :zephyr:code-sample:`hello_world` sample application:
 
    .. zephyr-app-commands::
       :zephyr-app: samples/hello_world
diff --git a/boards/hardkernel/odroid_go/doc/index.rst b/boards/hardkernel/odroid_go/doc/index.rst
index 86eb0af..62f38d4 100644
--- a/boards/hardkernel/odroid_go/doc/index.rst
+++ b/boards/hardkernel/odroid_go/doc/index.rst
@@ -192,7 +192,7 @@
    :goals: build
 
 The usual ``flash`` target will work with the ``odroid_go`` board
-configuration. Here is an example for the :ref:`hello_world`
+configuration. Here is an example for the :zephyr:code-sample:`hello_world`
 application.
 
 .. zephyr-app-commands::
@@ -225,7 +225,7 @@
 ``-DOPENOCD=<path/to/bin/openocd> -DOPENOCD_DEFAULT_PATH=<path/to/openocd/share/openocd/scripts>``
 parameter when building.
 
-Here is an example for building the :ref:`hello_world` application.
+Here is an example for building the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -233,7 +233,7 @@
    :goals: build flash
    :gen-args: -DOPENOCD=<path/to/bin/openocd> -DOPENOCD_DEFAULT_PATH=<path/to/openocd/share/openocd/scripts>
 
-You can debug an application in the usual way. Here is an example for the :ref:`hello_world` application.
+You can debug an application in the usual way. Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/heltec/heltec_wifi_lora32_v2/doc/index.rst b/boards/heltec/heltec_wifi_lora32_v2/doc/index.rst
index b1c0713..ee595e0 100644
--- a/boards/heltec/heltec_wifi_lora32_v2/doc/index.rst
+++ b/boards/heltec/heltec_wifi_lora32_v2/doc/index.rst
@@ -136,7 +136,7 @@
    :goals: build
 
 The usual ``flash`` target will work with the ``heltec_wifi_lora32_v2`` board
-configuration. Here is an example for the :ref:`hello_world`
+configuration. Here is an example for the :zephyr:code-sample:`hello_world`
 application.
 
 .. zephyr-app-commands::
@@ -169,7 +169,7 @@
 ``-DOPENOCD=<path/to/bin/openocd> -DOPENOCD_DEFAULT_PATH=<path/to/openocd/share/openocd/scripts>``
 parameter when building.
 
-Here is an example for building the :ref:`hello_world` application.
+Here is an example for building the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -177,7 +177,7 @@
    :goals: build flash
    :gen-args: -DOPENOCD=<path/to/bin/openocd> -DOPENOCD_DEFAULT_PATH=<path/to/openocd/share/openocd/scripts>
 
-You can debug an application in the usual way. Here is an example for the :ref:`hello_world` application.
+You can debug an application in the usual way. Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/heltec/heltec_wireless_stick_lite_v3/doc/index.rst b/boards/heltec/heltec_wireless_stick_lite_v3/doc/index.rst
index c2b141a..352d158 100644
--- a/boards/heltec/heltec_wireless_stick_lite_v3/doc/index.rst
+++ b/boards/heltec/heltec_wireless_stick_lite_v3/doc/index.rst
@@ -250,7 +250,7 @@
    :goals: build
 
 The usual ``flash`` target will work with the ``heltec_wireless_stick_lite_v3`` board
-configuration. Here is an example for the :ref:`hello_world`
+configuration. Here is an example for the :zephyr:code-sample:`hello_world`
 application.
 
 .. zephyr-app-commands::
@@ -283,7 +283,7 @@
 ``-DOPENOCD=<path/to/bin/openocd> -DOPENOCD_DEFAULT_PATH=<path/to/openocd/share/openocd/scripts>``
 parameter when building.
 
-Here is an example for building the :ref:`hello_world` application.
+Here is an example for building the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -291,7 +291,7 @@
    :goals: build flash
    :gen-args: -DOPENOCD=<path/to/bin/openocd> -DOPENOCD_DEFAULT_PATH=<path/to/openocd/share/openocd/scripts>
 
-You can debug an application in the usual way. Here is an example for the :ref:`hello_world` application.
+You can debug an application in the usual way. Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/infineon/xmc45_relax_kit/doc/index.rst b/boards/infineon/xmc45_relax_kit/doc/index.rst
index 89c9bcf..621fc1c 100644
--- a/boards/infineon/xmc45_relax_kit/doc/index.rst
+++ b/boards/infineon/xmc45_relax_kit/doc/index.rst
@@ -74,7 +74,7 @@
 Flashing
 ========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -84,7 +84,7 @@
 Debugging
 =========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/infineon/xmc47_relax_kit/doc/index.rst b/boards/infineon/xmc47_relax_kit/doc/index.rst
index 35457f3..57eb28e 100644
--- a/boards/infineon/xmc47_relax_kit/doc/index.rst
+++ b/boards/infineon/xmc47_relax_kit/doc/index.rst
@@ -77,7 +77,7 @@
 Flashing
 ========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -87,7 +87,7 @@
 Debugging
 =========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/innblue/innblue21/doc/index.rst b/boards/innblue/innblue21/doc/index.rst
index 333db42..0990c39 100644
--- a/boards/innblue/innblue21/doc/index.rst
+++ b/boards/innblue/innblue21/doc/index.rst
@@ -119,7 +119,7 @@
 applications as usual (see :ref:`build_an_application` and
 :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 First, run your favorite terminal program to listen for output.
 
diff --git a/boards/innblue/innblue22/doc/index.rst b/boards/innblue/innblue22/doc/index.rst
index 862c42c..3485ad4 100644
--- a/boards/innblue/innblue22/doc/index.rst
+++ b/boards/innblue/innblue22/doc/index.rst
@@ -119,7 +119,7 @@
 applications as usual (see :ref:`build_an_application` and
 :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 First, run your favorite terminal program to listen for output.
 
diff --git a/boards/intel/socfpga_std/cyclonev_socdk/doc/index.rst b/boards/intel/socfpga_std/cyclonev_socdk/doc/index.rst
index 752284a..6183491 100644
--- a/boards/intel/socfpga_std/cyclonev_socdk/doc/index.rst
+++ b/boards/intel/socfpga_std/cyclonev_socdk/doc/index.rst
@@ -163,7 +163,7 @@
 ------------------------------
 
 The usual ``flash`` target will work with the ``cyclonev_socdk`` board
-configuration. Here is an example for the :ref:`hello_world`
+configuration. Here is an example for the :zephyr:code-sample:`hello_world`
 application.
 
 ``Important!!!`` : Before flashing the board a ``preloader`` is required,
diff --git a/boards/ite/it82xx2_evb/doc/index.rst b/boards/ite/it82xx2_evb/doc/index.rst
index 0080c4f..d31b989 100644
--- a/boards/ite/it82xx2_evb/doc/index.rst
+++ b/boards/ite/it82xx2_evb/doc/index.rst
@@ -151,7 +151,7 @@
 Building
 ========
 
-#. Build :ref:`hello_world` application as you would normally do
+#. Build :zephyr:code-sample:`hello_world` application as you would normally do
    (see :`Zephyr Getting Started Guide`_):.
 
    .. zephyr-app-commands::
diff --git a/boards/ite/it8xxx2_evb/doc/index.rst b/boards/ite/it8xxx2_evb/doc/index.rst
index 5fab9cc..0e215fd 100644
--- a/boards/ite/it8xxx2_evb/doc/index.rst
+++ b/boards/ite/it8xxx2_evb/doc/index.rst
@@ -133,7 +133,7 @@
 Building
 ========
 
-#. Build :ref:`hello_world` application as you would normally do
+#. Build :zephyr:code-sample:`hello_world` application as you would normally do
    (see :`Zephyr Getting Started Guide`_):.
 
    .. zephyr-app-commands::
diff --git a/boards/khadas/edgev/doc/index.rst b/boards/khadas/edgev/doc/index.rst
index 2c73d109..c6c3e44 100644
--- a/boards/khadas/edgev/doc/index.rst
+++ b/boards/khadas/edgev/doc/index.rst
@@ -41,7 +41,7 @@
 *************************
 
 Use the following configuration to run basic Zephyr applications and
-kernel tests on Khadas Edge-V board. For example, with the :ref:`hello_world`:
+kernel tests on Khadas Edge-V board. For example, with the :zephyr:code-sample:`hello_world`:
 
 1. Non-SMP mode
 
diff --git a/boards/kincony/kincony_kc868_a32/doc/index.rst b/boards/kincony/kincony_kc868_a32/doc/index.rst
index a6117be..ccc8676 100644
--- a/boards/kincony/kincony_kc868_a32/doc/index.rst
+++ b/boards/kincony/kincony_kc868_a32/doc/index.rst
@@ -58,7 +58,7 @@
    :goals: build
 
 The usual ``flash`` target will work with the ``kincony_kc868_a32`` board
-configuration. Here is an example for the :ref:`hello_world`
+configuration. Here is an example for the :zephyr:code-sample:`hello_world`
 application.
 
 .. zephyr-app-commands::
diff --git a/boards/lilygo/ttgo_lora32/doc/index.rst b/boards/lilygo/ttgo_lora32/doc/index.rst
index 6814a66..c7a0442 100644
--- a/boards/lilygo/ttgo_lora32/doc/index.rst
+++ b/boards/lilygo/ttgo_lora32/doc/index.rst
@@ -179,7 +179,7 @@
    :goals: build
 
 The usual ``flash`` target will work with the ``ttgo_lora32`` board
-configuration. Here is an example for the :ref:`hello_world`
+configuration. Here is an example for the :zephyr:code-sample:`hello_world`
 application.
 
 .. zephyr-app-commands::
diff --git a/boards/lilygo/ttgo_t8c3/doc/index.rst b/boards/lilygo/ttgo_t8c3/doc/index.rst
index e4ad397..2b11dd9 100644
--- a/boards/lilygo/ttgo_t8c3/doc/index.rst
+++ b/boards/lilygo/ttgo_t8c3/doc/index.rst
@@ -177,7 +177,7 @@
    :goals: build
 
 The usual ``flash`` target will work with the ``ttgo_t8c3`` board
-configuration. Here is an example for the :ref:`hello_world`
+configuration. Here is an example for the :zephyr:code-sample:`hello_world`
 application.
 
 .. zephyr-app-commands::
diff --git a/boards/lowrisc/opentitan_earlgrey/doc/index.rst b/boards/lowrisc/opentitan_earlgrey/doc/index.rst
index f3edf95..b91c070 100644
--- a/boards/lowrisc/opentitan_earlgrey/doc/index.rst
+++ b/boards/lowrisc/opentitan_earlgrey/doc/index.rst
@@ -57,7 +57,7 @@
 Building and Flashing
 =====================
 
-Here is an example for building the :ref:`hello_world` application. The
+Here is an example for building the :zephyr:code-sample:`hello_world` application. The
 following steps were tested on OpenTitan master branch @ 6a3c2e98.
 
 .. zephyr-app-commands::
diff --git a/boards/luatos/esp32c3_luatos_core/doc/index.rst b/boards/luatos/esp32c3_luatos_core/doc/index.rst
index 03a9ccc..2e0d5ed 100644
--- a/boards/luatos/esp32c3_luatos_core/doc/index.rst
+++ b/boards/luatos/esp32c3_luatos_core/doc/index.rst
@@ -203,7 +203,7 @@
    :goals: build
 
 The usual ``flash`` target will work with the ``esp32c3_luatos_core`` board
-configuration. Here is an example for the :ref:`hello_world`
+configuration. Here is an example for the :zephyr:code-sample:`hello_world`
 application.
 
 .. zephyr-app-commands::
@@ -236,7 +236,7 @@
 ``-DOPENOCD=<path/to/bin/openocd> -DOPENOCD_DEFAULT_PATH=<path/to/openocd/share/openocd/scripts>``
 parameter when building.
 
-Here is an example for building the :ref:`hello_world` application.
+Here is an example for building the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -244,7 +244,7 @@
    :goals: build flash
    :gen-args: -DOPENOCD=<path/to/bin/openocd> -DOPENOCD_DEFAULT_PATH=<path/to/openocd/share/openocd/scripts>
 
-You can debug an application in the usual way. Here is an example for the :ref:`hello_world` application.
+You can debug an application in the usual way. Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/luatos/esp32s3_luatos_core/doc/index.rst b/boards/luatos/esp32s3_luatos_core/doc/index.rst
index 9a5bec4..7aa4310 100644
--- a/boards/luatos/esp32s3_luatos_core/doc/index.rst
+++ b/boards/luatos/esp32s3_luatos_core/doc/index.rst
@@ -237,7 +237,7 @@
    :goals: build
 
 The usual ``flash`` target will work with the ``esp32s3_luatos_core`` board
-configuration. Here is an example for the :ref:`hello_world`
+configuration. Here is an example for the :zephyr:code-sample:`hello_world`
 application.
 
 .. zephyr-app-commands::
@@ -268,14 +268,14 @@
 
 Further documentation can be obtained from the SoC vendor in `JTAG debugging for ESP32-S3`_.
 
-Here is an example for building the :ref:`hello_world` application.
+Here is an example for building the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
    :board: esp32s3_luatos_core/esp32s3/procpu
    :goals: build flash
 
-You can debug an application in the usual way. Here is an example for the :ref:`hello_world` application.
+You can debug an application in the usual way. Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/m5stack/m5stack_atom_lite/doc/index.rst b/boards/m5stack/m5stack_atom_lite/doc/index.rst
index 2e8c1fa..6a47c4a 100644
--- a/boards/m5stack/m5stack_atom_lite/doc/index.rst
+++ b/boards/m5stack/m5stack_atom_lite/doc/index.rst
@@ -96,7 +96,7 @@
    :goals: build
 
 The usual ``flash`` target will work with the ``m5stack_atom_lite`` board
-configuration. Here is an example for the :ref:`hello_world`
+configuration. Here is an example for the :zephyr:code-sample:`hello_world`
 application.
 
 .. zephyr-app-commands::
diff --git a/boards/m5stack/m5stack_atoms3/doc/index.rst b/boards/m5stack/m5stack_atoms3/doc/index.rst
index c053f73..69bff1e 100644
--- a/boards/m5stack/m5stack_atoms3/doc/index.rst
+++ b/boards/m5stack/m5stack_atoms3/doc/index.rst
@@ -98,7 +98,7 @@
    :goals: build
 
 The usual ``flash`` target will work with the ``m5stack_atoms3`` board
-configuration. Here is an example for the :ref:`hello_world`
+configuration. Here is an example for the :zephyr:code-sample:`hello_world`
 application.
 
 .. zephyr-app-commands::
diff --git a/boards/m5stack/m5stack_atoms3_lite/doc/index.rst b/boards/m5stack/m5stack_atoms3_lite/doc/index.rst
index 204d8e5..ffbe8f1 100644
--- a/boards/m5stack/m5stack_atoms3_lite/doc/index.rst
+++ b/boards/m5stack/m5stack_atoms3_lite/doc/index.rst
@@ -96,7 +96,7 @@
    :goals: build
 
 The usual ``flash`` target will work with the ``m5stack_atoms3_lite`` board
-configuration. Here is an example for the :ref:`hello_world`
+configuration. Here is an example for the :zephyr:code-sample:`hello_world`
 application.
 
 .. zephyr-app-commands::
diff --git a/boards/m5stack/m5stack_core2/doc/index.rst b/boards/m5stack/m5stack_core2/doc/index.rst
index c7a907a..02ba5fa 100644
--- a/boards/m5stack/m5stack_core2/doc/index.rst
+++ b/boards/m5stack/m5stack_core2/doc/index.rst
@@ -183,7 +183,7 @@
    :goals: build
 
 The usual ``flash`` target will work with the ``m5stack_core2`` board
-configuration. Here is an example for the :ref:`hello_world`
+configuration. Here is an example for the :zephyr:code-sample:`hello_world`
 application.
 
 .. zephyr-app-commands::
diff --git a/boards/m5stack/m5stack_stamps3/doc/index.rst b/boards/m5stack/m5stack_stamps3/doc/index.rst
index 59e1d51..3688112 100644
--- a/boards/m5stack/m5stack_stamps3/doc/index.rst
+++ b/boards/m5stack/m5stack_stamps3/doc/index.rst
@@ -153,7 +153,7 @@
    :goals: build
 
 The usual ``flash`` target will work with the ``m5stack_stamps3`` board
-configuration. Here is an example for the :ref:`hello_world`
+configuration. Here is an example for the :zephyr:code-sample:`hello_world`
 application.
 
 .. zephyr-app-commands::
diff --git a/boards/m5stack/m5stickc_plus/doc/index.rst b/boards/m5stack/m5stickc_plus/doc/index.rst
index e59da05..4fe431f 100644
--- a/boards/m5stack/m5stickc_plus/doc/index.rst
+++ b/boards/m5stack/m5stickc_plus/doc/index.rst
@@ -181,7 +181,7 @@
    :goals: build
 
 The usual ``flash`` target will work with the ``m5stickc_plus`` board
-configuration. Here is an example for the :ref:`hello_world`
+configuration. Here is an example for the :zephyr:code-sample:`hello_world`
 application.
 
 .. zephyr-app-commands::
diff --git a/boards/m5stack/stamp_c3/doc/index.rst b/boards/m5stack/stamp_c3/doc/index.rst
index 721c62e..40869ee 100644
--- a/boards/m5stack/stamp_c3/doc/index.rst
+++ b/boards/m5stack/stamp_c3/doc/index.rst
@@ -150,7 +150,7 @@
    :goals: build
 
 The usual ``flash`` target will work with the ``stamp_c3`` board
-configuration. Here is an example for the :ref:`hello_world`
+configuration. Here is an example for the :zephyr:code-sample:`hello_world`
 application.
 
 .. zephyr-app-commands::
@@ -183,7 +183,7 @@
 ``-DOPENOCD=<path/to/bin/openocd> -DOPENOCD_DEFAULT_PATH=<path/to/openocd/share/openocd/scripts>``
 parameter when building.
 
-Here is an example for building the :ref:`hello_world` application.
+Here is an example for building the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -191,7 +191,7 @@
    :goals: build flash
    :gen-args: -DOPENOCD=<path/to/bin/openocd> -DOPENOCD_DEFAULT_PATH=<path/to/openocd/share/openocd/scripts>
 
-You can debug an application in the usual way. Here is an example for the :ref:`hello_world` application.
+You can debug an application in the usual way. Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/madmachine/mm_feather/doc/index.rst b/boards/madmachine/mm_feather/doc/index.rst
index 5b53ddf..0a556bc 100644
--- a/boards/madmachine/mm_feather/doc/index.rst
+++ b/boards/madmachine/mm_feather/doc/index.rst
@@ -195,7 +195,7 @@
 Flashing
 ========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 Connect a DAPLink debugger from your PC to corresponding SWD pins of SwiftIO Feather.
 
@@ -215,7 +215,7 @@
 Debugging
 =========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/madmachine/mm_swiftio/doc/index.rst b/boards/madmachine/mm_swiftio/doc/index.rst
index d936140..5fb0837 100644
--- a/boards/madmachine/mm_swiftio/doc/index.rst
+++ b/boards/madmachine/mm_swiftio/doc/index.rst
@@ -206,7 +206,7 @@
 Flashing
 ========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 Connect a USB cable from your PC to "Serial" port of SwiftIO.
 On Ubuntu, DAPLink debug probes appear on the host
diff --git a/boards/microchip/mec1501modular_assy6885/doc/index.rst b/boards/microchip/mec1501modular_assy6885/doc/index.rst
index a74f481..a70c20e 100644
--- a/boards/microchip/mec1501modular_assy6885/doc/index.rst
+++ b/boards/microchip/mec1501modular_assy6885/doc/index.rst
@@ -260,7 +260,7 @@
 
 Building
 ==========
-#. Build :ref:`hello_world` application as you would normally do.
+#. Build :zephyr:code-sample:`hello_world` application as you would normally do.
 
 #. Once you have ``zephyr.bin``, use the `MEC152x SPI Image Gen`_ microchip tool
    to create the final binary. You need the output from this tool to flash
diff --git a/boards/microchip/mec15xxevb_assy6853/doc/index.rst b/boards/microchip/mec15xxevb_assy6853/doc/index.rst
index e3b29e9..4eafd2e 100644
--- a/boards/microchip/mec15xxevb_assy6853/doc/index.rst
+++ b/boards/microchip/mec15xxevb_assy6853/doc/index.rst
@@ -352,7 +352,7 @@
 
 Building
 ========
-#. Build :ref:`hello_world` application as you would normally do.
+#. Build :zephyr:code-sample:`hello_world` application as you would normally do.
 
 #. The file :file:`spi_image.bin` will be created if the build system
    can find the image generation tool. This binary image can be used
diff --git a/boards/microchip/mec172xevb_assy6906/doc/index.rst b/boards/microchip/mec172xevb_assy6906/doc/index.rst
index a2100e5..4765d78 100644
--- a/boards/microchip/mec172xevb_assy6906/doc/index.rst
+++ b/boards/microchip/mec172xevb_assy6906/doc/index.rst
@@ -360,7 +360,7 @@
 Building
 ========
 
-#. Build :ref:`hello_world` application as you would normally do.
+#. Build :zephyr:code-sample:`hello_world` application as you would normally do.
 
 #. The file :file:`spi_image.bin` will be created if the build system
    can find the image generation tool. This binary image can be used
diff --git a/boards/microchip/mec172xmodular_assy6930/doc/mec172xmodular_assy6930.rst b/boards/microchip/mec172xmodular_assy6930/doc/mec172xmodular_assy6930.rst
index a3a8548..a85226e 100644
--- a/boards/microchip/mec172xmodular_assy6930/doc/mec172xmodular_assy6930.rst
+++ b/boards/microchip/mec172xmodular_assy6930/doc/mec172xmodular_assy6930.rst
@@ -241,7 +241,7 @@
 Building
 ========
 
-#. Build :ref:`hello_world` application as you would normally do.
+#. Build :zephyr:code-sample:`hello_world` application as you would normally do.
 
 #. The file :file:`spi_image.bin` will be created if the build system
    can find the image generation tool. This binary image can be used
diff --git a/boards/mikroe/clicker_2/doc/mikroe_clicker_2.rst b/boards/mikroe/clicker_2/doc/mikroe_clicker_2.rst
index 99cb9ce0..a1ef4aa 100644
--- a/boards/mikroe/clicker_2/doc/mikroe_clicker_2.rst
+++ b/boards/mikroe/clicker_2/doc/mikroe_clicker_2.rst
@@ -91,7 +91,7 @@
        -f /usr/share/openocd/scripts/target/stm32f4x.cfg -c init\
        -c "reset halt" -c "stm32f4x unlock 0" -c "reset run" -c shutdown
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -109,7 +109,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/mikroe/mini_m4_for_stm32/doc/mikroe_mini_m4_for_stm32.rst b/boards/mikroe/mini_m4_for_stm32/doc/mikroe_mini_m4_for_stm32.rst
index 7198f2d..6194953 100644
--- a/boards/mikroe/mini_m4_for_stm32/doc/mikroe_mini_m4_for_stm32.rst
+++ b/boards/mikroe/mini_m4_for_stm32/doc/mikroe_mini_m4_for_stm32.rst
@@ -118,7 +118,7 @@
        -f /usr/share/openocd/scripts/target/stm32f4x.cfg -c init\
        -c "reset halt" -c "stm32f4x unlock 0" -c "reset run" -c shutdown
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -135,7 +135,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/mxchip/az3166_iotdevkit/doc/index.rst b/boards/mxchip/az3166_iotdevkit/doc/index.rst
index 2e44339..694d535 100644
--- a/boards/mxchip/az3166_iotdevkit/doc/index.rst
+++ b/boards/mxchip/az3166_iotdevkit/doc/index.rst
@@ -76,7 +76,7 @@
 Build and flash applications as usual (see :ref:`build_an_application` and
 :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 First, run your favorite terminal program to listen for output.
 
diff --git a/boards/nordic/nrf21540dk/doc/index.rst b/boards/nordic/nrf21540dk/doc/index.rst
index 8ea583e..7ed102b 100644
--- a/boards/nordic/nrf21540dk/doc/index.rst
+++ b/boards/nordic/nrf21540dk/doc/index.rst
@@ -135,7 +135,7 @@
 applications as usual (see :ref:`build_an_application` and
 :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 First, run your favorite terminal program to listen for output.
 
diff --git a/boards/nordic/nrf51dk/doc/index.rst b/boards/nordic/nrf51dk/doc/index.rst
index c905dc0..f5a2acb 100644
--- a/boards/nordic/nrf51dk/doc/index.rst
+++ b/boards/nordic/nrf51dk/doc/index.rst
@@ -110,7 +110,7 @@
 applications as usual (see :ref:`build_an_application` and
 :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 First, run your favorite terminal program to listen for output.
 
diff --git a/boards/nordic/nrf51dongle/doc/index.rst b/boards/nordic/nrf51dongle/doc/index.rst
index d818337..63f288e 100644
--- a/boards/nordic/nrf51dongle/doc/index.rst
+++ b/boards/nordic/nrf51dongle/doc/index.rst
@@ -105,7 +105,7 @@
 applications as usual (see :ref:`build_an_application` and
 :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 First, run your favorite terminal program to listen for output.
 
diff --git a/boards/nordic/nrf52833dk/doc/index.rst b/boards/nordic/nrf52833dk/doc/index.rst
index 027f471..ed057bb 100644
--- a/boards/nordic/nrf52833dk/doc/index.rst
+++ b/boards/nordic/nrf52833dk/doc/index.rst
@@ -119,7 +119,7 @@
 applications as usual (see :ref:`build_an_application` and
 :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 First, run your favorite terminal program to listen for output.
 
diff --git a/boards/nordic/nrf52840dk/doc/index.rst b/boards/nordic/nrf52840dk/doc/index.rst
index faa7f07..7c948d7 100644
--- a/boards/nordic/nrf52840dk/doc/index.rst
+++ b/boards/nordic/nrf52840dk/doc/index.rst
@@ -124,7 +124,7 @@
 applications as usual (see :ref:`build_an_application` and
 :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 First, run your favorite terminal program to listen for output.
 
diff --git a/boards/nordic/nrf52dk/doc/index.rst b/boards/nordic/nrf52dk/doc/index.rst
index 4ebcac4..61349e8 100644
--- a/boards/nordic/nrf52dk/doc/index.rst
+++ b/boards/nordic/nrf52dk/doc/index.rst
@@ -357,7 +357,7 @@
 applications as usual (see :ref:`build_an_application` and
 :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 First, run your favorite terminal program to listen for output.
 
diff --git a/boards/nordic/nrf5340dk/doc/index.rst b/boards/nordic/nrf5340dk/doc/index.rst
index e933f43..9aa3f79 100644
--- a/boards/nordic/nrf5340dk/doc/index.rst
+++ b/boards/nordic/nrf5340dk/doc/index.rst
@@ -278,7 +278,7 @@
    information on how to install the nRF Command Line Tools can be
    found in :ref:`nordic_segger_flashing`.
 
-Here is an example for the :ref:`hello_world` application running on the
+Here is an example for the :zephyr:code-sample:`hello_world` application running on the
 nRF5340 application core.
 
 First, run your favorite terminal program to listen for output.
diff --git a/boards/nordic/nrf54h20dk/doc/index.rst b/boards/nordic/nrf54h20dk/doc/index.rst
index 6aa59b7..4130635 100644
--- a/boards/nordic/nrf54h20dk/doc/index.rst
+++ b/boards/nordic/nrf54h20dk/doc/index.rst
@@ -129,7 +129,7 @@
 Flashing
 ========
 
-As an example, this section shows how to build and flash the :ref:`hello_world`
+As an example, this section shows how to build and flash the :zephyr:code-sample:`hello_world`
 application.
 
 To build and program the sample to the nRF54H20 DK, complete the following steps:
diff --git a/boards/nordic/nrf54l15dk/doc/index.rst b/boards/nordic/nrf54l15dk/doc/index.rst
index d411032..7d45091 100644
--- a/boards/nordic/nrf54l15dk/doc/index.rst
+++ b/boards/nordic/nrf54l15dk/doc/index.rst
@@ -103,7 +103,7 @@
 Flashing
 ========
 
-As an example, this section shows how to build and flash the :ref:`hello_world`
+As an example, this section shows how to build and flash the :zephyr:code-sample:`hello_world`
 application.
 
 .. warning::
diff --git a/boards/nordic/nrf54l15pdk/doc/index.rst b/boards/nordic/nrf54l15pdk/doc/index.rst
index ccc6230..dc6e69b 100644
--- a/boards/nordic/nrf54l15pdk/doc/index.rst
+++ b/boards/nordic/nrf54l15pdk/doc/index.rst
@@ -97,7 +97,7 @@
 Flashing
 ========
 
-As an example, this section shows how to build and flash the :ref:`hello_world`
+As an example, this section shows how to build and flash the :zephyr:code-sample:`hello_world`
 application.
 
 .. warning::
diff --git a/boards/nordic/nrf54l20pdk/doc/index.rst b/boards/nordic/nrf54l20pdk/doc/index.rst
index 2297df5..aaed616 100644
--- a/boards/nordic/nrf54l20pdk/doc/index.rst
+++ b/boards/nordic/nrf54l20pdk/doc/index.rst
@@ -68,7 +68,7 @@
 Flashing
 ========
 
-As an example, this section shows how to build and flash the :ref:`hello_world`
+As an example, this section shows how to build and flash the :zephyr:code-sample:`hello_world`
 application.
 
 Follow the instructions in the :ref:`nordic_segger` page to install
diff --git a/boards/nordic/nrf7002dk/doc/index.rst b/boards/nordic/nrf7002dk/doc/index.rst
index 5b25a7a..3e3153c 100644
--- a/boards/nordic/nrf7002dk/doc/index.rst
+++ b/boards/nordic/nrf7002dk/doc/index.rst
@@ -278,7 +278,7 @@
    information on how to install the nRF Command Line Tools can be
    found in :ref:`nordic_segger_flashing`.
 
-Here is an example for the :ref:`hello_world` application running on the
+Here is an example for the :zephyr:code-sample:`hello_world` application running on the
 nRF5340 application core.
 
 First, run your favorite terminal program to listen for output.
diff --git a/boards/nordic/nrf9131ek/doc/index.rst b/boards/nordic/nrf9131ek/doc/index.rst
index accd403..236f6b3 100644
--- a/boards/nordic/nrf9131ek/doc/index.rst
+++ b/boards/nordic/nrf9131ek/doc/index.rst
@@ -180,7 +180,7 @@
 applications as usual (see :ref:`build_an_application` and
 :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 First, run your favorite terminal program to listen for output.
 
diff --git a/boards/nordic/nrf9151dk/doc/index.rst b/boards/nordic/nrf9151dk/doc/index.rst
index 4017347..2365de5 100644
--- a/boards/nordic/nrf9151dk/doc/index.rst
+++ b/boards/nordic/nrf9151dk/doc/index.rst
@@ -150,7 +150,7 @@
 applications as usual (see :ref:`build_an_application` and
 :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 First, run your favorite terminal program to listen for output.
 
diff --git a/boards/nordic/nrf9160dk/doc/index.rst b/boards/nordic/nrf9160dk/doc/index.rst
index 70fd2c2..a91cf76 100644
--- a/boards/nordic/nrf9160dk/doc/index.rst
+++ b/boards/nordic/nrf9160dk/doc/index.rst
@@ -214,7 +214,7 @@
 applications as usual (see :ref:`build_an_application` and
 :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 First, run your favorite terminal program to listen for output.
 
@@ -346,7 +346,7 @@
 
 Remember to set the PROG/DEBUG switch on the DK to nRF52.
 
-See the following example for the :ref:`hello_world` application.
+See the following example for the :zephyr:code-sample:`hello_world` application.
 
 First, run your favorite terminal program to listen for output.
 
diff --git a/boards/nordic/nrf9161dk/doc/index.rst b/boards/nordic/nrf9161dk/doc/index.rst
index 251c846..bb9d4ee 100644
--- a/boards/nordic/nrf9161dk/doc/index.rst
+++ b/boards/nordic/nrf9161dk/doc/index.rst
@@ -153,7 +153,7 @@
 applications as usual (see :ref:`build_an_application` and
 :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 First, run your favorite terminal program to listen for output.
 
diff --git a/boards/nordic/nrf9280pdk/doc/index.rst b/boards/nordic/nrf9280pdk/doc/index.rst
index 052d2e5..3942292 100644
--- a/boards/nordic/nrf9280pdk/doc/index.rst
+++ b/boards/nordic/nrf9280pdk/doc/index.rst
@@ -71,7 +71,7 @@
 Flashing
 ========
 
-As an example, this section shows how to build and flash the :ref:`hello_world`
+As an example, this section shows how to build and flash the :zephyr:code-sample:`hello_world`
 application.
 
 Follow the instructions in the :ref:`nordic_segger` page to install
diff --git a/boards/nuvoton/npcm400_evb/doc/index.rst b/boards/nuvoton/npcm400_evb/doc/index.rst
index 930ac3d..d5d9ee5 100644
--- a/boards/nuvoton/npcm400_evb/doc/index.rst
+++ b/boards/nuvoton/npcm400_evb/doc/index.rst
@@ -86,7 +86,7 @@
 To flash with J-TAG, install the drivers for your programmer, for example:
 SEGGER J-link's drivers are at https://www.segger.com/downloads/jlink/
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
     :zephyr-app: samples/hello_world
diff --git a/boards/nuvoton/numaker_m2l31ki/doc/index.rst b/boards/nuvoton/numaker_m2l31ki/doc/index.rst
index 3e2c8b9..8c2e8b8 100644
--- a/boards/nuvoton/numaker_m2l31ki/doc/index.rst
+++ b/boards/nuvoton/numaker_m2l31ki/doc/index.rst
@@ -58,7 +58,7 @@
 Flashing
 ========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 On board debugger Nu-link2 can emulate UART0 as a virtual COM port over usb,
 To enable this, set ISW1 DIP switch 1-3 (TXD RXD VOM) to ON.
@@ -77,7 +77,7 @@
 Debugging
 =========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/nuvoton/numaker_pfm_m467/doc/index.rst b/boards/nuvoton/numaker_pfm_m467/doc/index.rst
index 483ab34..6620acc 100644
--- a/boards/nuvoton/numaker_pfm_m467/doc/index.rst
+++ b/boards/nuvoton/numaker_pfm_m467/doc/index.rst
@@ -62,7 +62,7 @@
 Flashing
 ========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 On board debugger Nu-link2 can emulate UART0 as a virtual COM port over usb,
 To enable this, set ISW1 DIP switch 1-3 (TXD RXD VOM) to ON.
@@ -81,7 +81,7 @@
 Debugging
 =========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/nuvoton/numaker_pfm_m487/doc/index.rst b/boards/nuvoton/numaker_pfm_m487/doc/index.rst
index 323be5f..180ae3c 100644
--- a/boards/nuvoton/numaker_pfm_m487/doc/index.rst
+++ b/boards/nuvoton/numaker_pfm_m487/doc/index.rst
@@ -61,7 +61,7 @@
 Flashing
 ========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 On board debugger Nu-link-Me can emulate UART0 as a virtual COM port over usb,
 To enable this, set ISW1 DIP switch 1-3 (TXD RXD VOM) to ON.
@@ -80,7 +80,7 @@
 Debugging
 =========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/nxp/frdm_k22f/doc/index.rst b/boards/nxp/frdm_k22f/doc/index.rst
index b92fa50..2e5ea18 100644
--- a/boards/nxp/frdm_k22f/doc/index.rst
+++ b/boards/nxp/frdm_k22f/doc/index.rst
@@ -237,7 +237,7 @@
 Flashing
 ========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -255,7 +255,7 @@
 Debugging
 =========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/nxp/frdm_k64f/doc/index.rst b/boards/nxp/frdm_k64f/doc/index.rst
index 1c240ef..17af8d4 100644
--- a/boards/nxp/frdm_k64f/doc/index.rst
+++ b/boards/nxp/frdm_k64f/doc/index.rst
@@ -309,7 +309,7 @@
 Flashing
 ========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -327,7 +327,7 @@
 Debugging
 =========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/nxp/frdm_k82f/doc/index.rst b/boards/nxp/frdm_k82f/doc/index.rst
index f306dc6..9903e1b 100644
--- a/boards/nxp/frdm_k82f/doc/index.rst
+++ b/boards/nxp/frdm_k82f/doc/index.rst
@@ -194,7 +194,7 @@
 Flashing
 ========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -212,7 +212,7 @@
 Debugging
 =========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/nxp/frdm_ke15z/doc/index.rst b/boards/nxp/frdm_ke15z/doc/index.rst
index fd1dec9..772de4f 100644
--- a/boards/nxp/frdm_ke15z/doc/index.rst
+++ b/boards/nxp/frdm_ke15z/doc/index.rst
@@ -129,7 +129,7 @@
 Flashing
 ========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -147,7 +147,7 @@
 Debugging
 =========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/nxp/frdm_ke17z/doc/index.rst b/boards/nxp/frdm_ke17z/doc/index.rst
index 7fb9f29..1f15fc9 100644
--- a/boards/nxp/frdm_ke17z/doc/index.rst
+++ b/boards/nxp/frdm_ke17z/doc/index.rst
@@ -156,7 +156,7 @@
 Flashing
 ========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -174,7 +174,7 @@
 Debugging
 =========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/nxp/frdm_ke17z512/doc/index.rst b/boards/nxp/frdm_ke17z512/doc/index.rst
index 3e5be80..ab49483 100644
--- a/boards/nxp/frdm_ke17z512/doc/index.rst
+++ b/boards/nxp/frdm_ke17z512/doc/index.rst
@@ -152,7 +152,7 @@
 Flashing
 ========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -170,7 +170,7 @@
 Debugging
 =========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/nxp/frdm_kl25z/doc/index.rst b/boards/nxp/frdm_kl25z/doc/index.rst
index 6695974..215c476 100644
--- a/boards/nxp/frdm_kl25z/doc/index.rst
+++ b/boards/nxp/frdm_kl25z/doc/index.rst
@@ -189,7 +189,7 @@
 Flashing
 ========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -207,7 +207,7 @@
 Debugging
 =========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/nxp/frdm_kw41z/doc/index.rst b/boards/nxp/frdm_kw41z/doc/index.rst
index 4457b6d..b164393 100644
--- a/boards/nxp/frdm_kw41z/doc/index.rst
+++ b/boards/nxp/frdm_kw41z/doc/index.rst
@@ -201,7 +201,7 @@
 Flashing
 ========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -219,7 +219,7 @@
 Debugging
 =========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/nxp/frdm_mcxa156/doc/index.rst b/boards/nxp/frdm_mcxa156/doc/index.rst
index 9625547..df622a4 100644
--- a/boards/nxp/frdm_mcxa156/doc/index.rst
+++ b/boards/nxp/frdm_mcxa156/doc/index.rst
@@ -149,7 +149,7 @@
 Flashing
 ========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -167,7 +167,7 @@
 Debugging
 =========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/nxp/frdm_mcxc242/doc/index.rst b/boards/nxp/frdm_mcxc242/doc/index.rst
index 4d5b0f8..ecde164 100644
--- a/boards/nxp/frdm_mcxc242/doc/index.rst
+++ b/boards/nxp/frdm_mcxc242/doc/index.rst
@@ -171,7 +171,7 @@
 Flashing
 ========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -189,7 +189,7 @@
 Debugging
 =========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/nxp/frdm_mcxn236/doc/index.rst b/boards/nxp/frdm_mcxn236/doc/index.rst
index 0793d68..3ee20c5 100644
--- a/boards/nxp/frdm_mcxn236/doc/index.rst
+++ b/boards/nxp/frdm_mcxn236/doc/index.rst
@@ -156,7 +156,7 @@
 Flashing
 ========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -174,7 +174,7 @@
 Debugging
 =========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/nxp/frdm_mcxn947/doc/index.rst b/boards/nxp/frdm_mcxn947/doc/index.rst
index 5febc07..1559dce 100644
--- a/boards/nxp/frdm_mcxn947/doc/index.rst
+++ b/boards/nxp/frdm_mcxn947/doc/index.rst
@@ -190,7 +190,7 @@
 Flashing
 ========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -208,7 +208,7 @@
 Flashing to QSPI
 ================
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :app: zephyr/samples/hello_world
@@ -245,7 +245,7 @@
 Debugging
 =========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/nxp/frdm_rw612/doc/index.rst b/boards/nxp/frdm_rw612/doc/index.rst
index f6aec20..0044b09 100644
--- a/boards/nxp/frdm_rw612/doc/index.rst
+++ b/boards/nxp/frdm_rw612/doc/index.rst
@@ -102,7 +102,7 @@
 Flashing
 ========
 
-Here is an example for the :ref:`hello_world` application. This example uses the
+Here is an example for the :zephyr:code-sample:`hello_world` application. This example uses the
 :ref:`jlink-debug-host-tools` as default.
 
 .. zephyr-app-commands::
@@ -121,7 +121,7 @@
 Debugging
 =========
 
-Here is an example for the :ref:`hello_world` application. This example uses the
+Here is an example for the :zephyr:code-sample:`hello_world` application. This example uses the
 :ref:`jlink-debug-host-tools` as default.
 
 .. zephyr-app-commands::
diff --git a/boards/nxp/hexiwear/doc/index.rst b/boards/nxp/hexiwear/doc/index.rst
index bc4d58a..6f47bdd 100644
--- a/boards/nxp/hexiwear/doc/index.rst
+++ b/boards/nxp/hexiwear/doc/index.rst
@@ -227,7 +227,7 @@
 Flashing
 ========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -245,7 +245,7 @@
 Debugging
 =========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -460,7 +460,7 @@
 Flashing
 ========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -486,7 +486,7 @@
 Debugging
 =========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/nxp/imx8mm_evk/doc/index.rst b/boards/nxp/imx8mm_evk/doc/index.rst
index e782798..d834726 100644
--- a/boards/nxp/imx8mm_evk/doc/index.rst
+++ b/boards/nxp/imx8mm_evk/doc/index.rst
@@ -222,7 +222,7 @@
 JTAG debugger to the J902 debug connector and to the PC. Then
 the application can be debugged using the usual way.
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/nxp/imx8mp_evk/doc/index.rst b/boards/nxp/imx8mp_evk/doc/index.rst
index 839288c..69a9b46 100644
--- a/boards/nxp/imx8mp_evk/doc/index.rst
+++ b/boards/nxp/imx8mp_evk/doc/index.rst
@@ -297,7 +297,7 @@
 JTAG debugger to the J24 debug connector and to the PC. Then
 the application can be debugged using the usual way.
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/nxp/imx8mq_evk/doc/index.rst b/boards/nxp/imx8mq_evk/doc/index.rst
index 40bd5ac..8f21c6e 100644
--- a/boards/nxp/imx8mq_evk/doc/index.rst
+++ b/boards/nxp/imx8mq_evk/doc/index.rst
@@ -190,7 +190,7 @@
 JTAG debugger to the J401 debug connector and to the PC. Then
 the application can be debugged using the usual way.
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/nxp/imx95_evk/doc/index.rst b/boards/nxp/imx95_evk/doc/index.rst
index e4664a2..3b7a69c 100644
--- a/boards/nxp/imx95_evk/doc/index.rst
+++ b/boards/nxp/imx95_evk/doc/index.rst
@@ -229,7 +229,7 @@
 See ``4.2 Run an example application``, just rename ``zephyr.bin`` to ``m7_image.bin``
 to make flash.bin and program to SD/eMMC.
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/nxp/lpcxpresso51u68/doc/index.rst b/boards/nxp/lpcxpresso51u68/doc/index.rst
index c1fff7e..491aa2b 100644
--- a/boards/nxp/lpcxpresso51u68/doc/index.rst
+++ b/boards/nxp/lpcxpresso51u68/doc/index.rst
@@ -133,7 +133,7 @@
 Flashing
 ========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -148,7 +148,7 @@
 Debugging
 =========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/nxp/lpcxpresso54114/doc/index.rst b/boards/nxp/lpcxpresso54114/doc/index.rst
index 0402d19..df2e2aa 100644
--- a/boards/nxp/lpcxpresso54114/doc/index.rst
+++ b/boards/nxp/lpcxpresso54114/doc/index.rst
@@ -166,7 +166,7 @@
 Flashing
 ========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -184,7 +184,7 @@
 Debugging
 =========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/nxp/lpcxpresso55s06/doc/index.rst b/boards/nxp/lpcxpresso55s06/doc/index.rst
index 01f7f6b..10a1b67 100644
--- a/boards/nxp/lpcxpresso55s06/doc/index.rst
+++ b/boards/nxp/lpcxpresso55s06/doc/index.rst
@@ -156,7 +156,7 @@
 Flashing
 ========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -174,7 +174,7 @@
 Debugging
 =========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/nxp/lpcxpresso55s16/doc/index.rst b/boards/nxp/lpcxpresso55s16/doc/index.rst
index f0d0c52..8089e3d 100644
--- a/boards/nxp/lpcxpresso55s16/doc/index.rst
+++ b/boards/nxp/lpcxpresso55s16/doc/index.rst
@@ -191,7 +191,7 @@
 Flashing
 ========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -209,7 +209,7 @@
 Debugging
 =========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/nxp/lpcxpresso55s28/doc/index.rst b/boards/nxp/lpcxpresso55s28/doc/index.rst
index 1e97071..df40571 100644
--- a/boards/nxp/lpcxpresso55s28/doc/index.rst
+++ b/boards/nxp/lpcxpresso55s28/doc/index.rst
@@ -164,7 +164,7 @@
 Flashing
 ========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -182,7 +182,7 @@
 Debugging
 =========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/nxp/lpcxpresso55s36/doc/index.rst b/boards/nxp/lpcxpresso55s36/doc/index.rst
index bff3ef5..32c7993 100644
--- a/boards/nxp/lpcxpresso55s36/doc/index.rst
+++ b/boards/nxp/lpcxpresso55s36/doc/index.rst
@@ -195,7 +195,7 @@
 Flashing
 ========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -213,7 +213,7 @@
 Debugging
 =========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/nxp/lpcxpresso55s69/doc/index.rst b/boards/nxp/lpcxpresso55s69/doc/index.rst
index 4c157c9..85336fa 100644
--- a/boards/nxp/lpcxpresso55s69/doc/index.rst
+++ b/boards/nxp/lpcxpresso55s69/doc/index.rst
@@ -322,7 +322,7 @@
 Flashing
 ========
 
-Here is an example for the :ref:`hello_world` application. This example uses the
+Here is an example for the :zephyr:code-sample:`hello_world` application. This example uses the
 :ref:`jlink-debug-host-tools` as default.
 
 .. zephyr-app-commands::
@@ -365,7 +365,7 @@
 Debugging
 =========
 
-Here is an example for the :ref:`hello_world` application. This example uses the
+Here is an example for the :zephyr:code-sample:`hello_world` application. This example uses the
 :ref:`jlink-debug-host-tools` as default.
 
 .. zephyr-app-commands::
diff --git a/boards/nxp/mimxrt1010_evk/doc/index.rst b/boards/nxp/mimxrt1010_evk/doc/index.rst
index c0d9670..6422927 100644
--- a/boards/nxp/mimxrt1010_evk/doc/index.rst
+++ b/boards/nxp/mimxrt1010_evk/doc/index.rst
@@ -201,7 +201,7 @@
 Flashing
 ========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
     :zephyr-app: samples/hello_world
diff --git a/boards/nxp/mimxrt1015_evk/doc/index.rst b/boards/nxp/mimxrt1015_evk/doc/index.rst
index fb81c2d..7e22bd4 100644
--- a/boards/nxp/mimxrt1015_evk/doc/index.rst
+++ b/boards/nxp/mimxrt1015_evk/doc/index.rst
@@ -203,7 +203,7 @@
 Flashing
 ========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
     :zephyr-app: samples/hello_world
diff --git a/boards/nxp/mimxrt1020_evk/doc/index.rst b/boards/nxp/mimxrt1020_evk/doc/index.rst
index 5e3f240..0057dcd 100644
--- a/boards/nxp/mimxrt1020_evk/doc/index.rst
+++ b/boards/nxp/mimxrt1020_evk/doc/index.rst
@@ -261,7 +261,7 @@
 Flashing
 ========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -279,7 +279,7 @@
 Debugging
 =========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/nxp/mimxrt1024_evk/doc/index.rst b/boards/nxp/mimxrt1024_evk/doc/index.rst
index 991c9c1..e451a02 100644
--- a/boards/nxp/mimxrt1024_evk/doc/index.rst
+++ b/boards/nxp/mimxrt1024_evk/doc/index.rst
@@ -243,7 +243,7 @@
 Flashing
 ========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -261,7 +261,7 @@
 Debugging
 =========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/nxp/mimxrt1040_evk/doc/index.rst b/boards/nxp/mimxrt1040_evk/doc/index.rst
index c632296..fffd387 100644
--- a/boards/nxp/mimxrt1040_evk/doc/index.rst
+++ b/boards/nxp/mimxrt1040_evk/doc/index.rst
@@ -252,7 +252,7 @@
 Flashing
 ========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -270,7 +270,7 @@
 Debugging
 =========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/nxp/mimxrt1050_evk/doc/index.rst b/boards/nxp/mimxrt1050_evk/doc/index.rst
index 8e283c0..19deec5 100644
--- a/boards/nxp/mimxrt1050_evk/doc/index.rst
+++ b/boards/nxp/mimxrt1050_evk/doc/index.rst
@@ -367,7 +367,7 @@
 Flashing
 ========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -385,7 +385,7 @@
 Debugging
 =========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/nxp/mimxrt1060_evk/doc/index.rst b/boards/nxp/mimxrt1060_evk/doc/index.rst
index b7df78d..e17f57e 100644
--- a/boards/nxp/mimxrt1060_evk/doc/index.rst
+++ b/boards/nxp/mimxrt1060_evk/doc/index.rst
@@ -378,7 +378,7 @@
 Flashing
 ========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -396,7 +396,7 @@
 Debugging
 =========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/nxp/mimxrt1062_fmurt6/doc/index.rst b/boards/nxp/mimxrt1062_fmurt6/doc/index.rst
index edcd5bc..e587a8c 100644
--- a/boards/nxp/mimxrt1062_fmurt6/doc/index.rst
+++ b/boards/nxp/mimxrt1062_fmurt6/doc/index.rst
@@ -303,7 +303,7 @@
 Flashing
 ========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -321,7 +321,7 @@
 Debugging
 =========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/nxp/mimxrt1064_evk/doc/index.rst b/boards/nxp/mimxrt1064_evk/doc/index.rst
index fdd2184..4f6fab6 100644
--- a/boards/nxp/mimxrt1064_evk/doc/index.rst
+++ b/boards/nxp/mimxrt1064_evk/doc/index.rst
@@ -373,7 +373,7 @@
 Flashing
 ========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -391,7 +391,7 @@
 Debugging
 =========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/nxp/mimxrt1160_evk/doc/index.rst b/boards/nxp/mimxrt1160_evk/doc/index.rst
index 8cc8b74..5b8a110 100644
--- a/boards/nxp/mimxrt1160_evk/doc/index.rst
+++ b/boards/nxp/mimxrt1160_evk/doc/index.rst
@@ -314,7 +314,7 @@
 Flashing
 ========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 Before power on the board, make sure SW1 is set to 0001b
 
@@ -335,7 +335,7 @@
 Debugging
 =========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/nxp/mimxrt1170_evk/doc/index.rst b/boards/nxp/mimxrt1170_evk/doc/index.rst
index c3de9f8..7500442 100644
--- a/boards/nxp/mimxrt1170_evk/doc/index.rst
+++ b/boards/nxp/mimxrt1170_evk/doc/index.rst
@@ -410,7 +410,7 @@
 Flashing
 ========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 Before powering the board, make sure SW1 is set to 0001b
 
@@ -431,7 +431,7 @@
 Debugging
 =========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/nxp/mimxrt1180_evk/doc/index.rst b/boards/nxp/mimxrt1180_evk/doc/index.rst
index 80926ed..71066d7 100644
--- a/boards/nxp/mimxrt1180_evk/doc/index.rst
+++ b/boards/nxp/mimxrt1180_evk/doc/index.rst
@@ -211,7 +211,7 @@
 Flashing
 ========
 
-Here is an example for the :ref:`hello_world` application on cm33 core.
+Here is an example for the :zephyr:code-sample:`hello_world` application on cm33 core.
 
 Before power on the board, make sure SW5 is set to 0100b
 
@@ -232,7 +232,7 @@
 Debugging
 =========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/nxp/mimxrt595_evk/doc/index.rst b/boards/nxp/mimxrt595_evk/doc/index.rst
index 5be8e0d..5465a91 100644
--- a/boards/nxp/mimxrt595_evk/doc/index.rst
+++ b/boards/nxp/mimxrt595_evk/doc/index.rst
@@ -244,7 +244,7 @@
 Flashing
 ========
 
-Here is an example for the :ref:`hello_world` application. This example uses the
+Here is an example for the :zephyr:code-sample:`hello_world` application. This example uses the
 :ref:`jlink-debug-host-tools` as default.
 
 .. zephyr-app-commands::
@@ -263,7 +263,7 @@
 Debugging
 =========
 
-Here is an example for the :ref:`hello_world` application. This example uses the
+Here is an example for the :zephyr:code-sample:`hello_world` application. This example uses the
 :ref:`jlink-debug-host-tools` as default.
 
 .. zephyr-app-commands::
diff --git a/boards/nxp/mimxrt685_evk/doc/index.rst b/boards/nxp/mimxrt685_evk/doc/index.rst
index 4e8f9d7..4f53d64 100644
--- a/boards/nxp/mimxrt685_evk/doc/index.rst
+++ b/boards/nxp/mimxrt685_evk/doc/index.rst
@@ -285,7 +285,7 @@
 Flashing
 ========
 
-Here is an example for the :ref:`hello_world` application. This example uses the
+Here is an example for the :zephyr:code-sample:`hello_world` application. This example uses the
 :ref:`linkserver-debug-host-tools` as default.
 
 .. zephyr-app-commands::
@@ -304,7 +304,7 @@
 Debugging
 =========
 
-Here is an example for the :ref:`hello_world` application. This example uses the
+Here is an example for the :zephyr:code-sample:`hello_world` application. This example uses the
 :ref:`linkserver-debug-host-tools` as default.
 
 .. zephyr-app-commands::
diff --git a/boards/nxp/rd_rw612_bga/doc/index.rst b/boards/nxp/rd_rw612_bga/doc/index.rst
index 558effd..e0215ec 100644
--- a/boards/nxp/rd_rw612_bga/doc/index.rst
+++ b/boards/nxp/rd_rw612_bga/doc/index.rst
@@ -111,7 +111,7 @@
 Flashing
 ========
 
-Here is an example for the :ref:`hello_world` application. This example uses the
+Here is an example for the :zephyr:code-sample:`hello_world` application. This example uses the
 :ref:`jlink-debug-host-tools` as default.
 
 .. zephyr-app-commands::
@@ -130,7 +130,7 @@
 Debugging
 =========
 
-Here is an example for the :ref:`hello_world` application. This example uses the
+Here is an example for the :zephyr:code-sample:`hello_world` application. This example uses the
 :ref:`jlink-debug-host-tools` as default.
 
 .. zephyr-app-commands::
diff --git a/boards/nxp/rddrone_fmuk66/doc/index.rst b/boards/nxp/rddrone_fmuk66/doc/index.rst
index 69d8624..e938c68 100644
--- a/boards/nxp/rddrone_fmuk66/doc/index.rst
+++ b/boards/nxp/rddrone_fmuk66/doc/index.rst
@@ -144,7 +144,7 @@
 Flashing
 ========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -162,7 +162,7 @@
 Debugging
 =========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/nxp/s32z2xxdc2/doc/index.rst b/boards/nxp/s32z2xxdc2/doc/index.rst
index 58e5ea3..d864059 100644
--- a/boards/nxp/s32z2xxdc2/doc/index.rst
+++ b/boards/nxp/s32z2xxdc2/doc/index.rst
@@ -200,7 +200,7 @@
 Debugging
 =========
 
-You can build and debug the :ref:`hello_world` sample for the board
+You can build and debug the :zephyr:code-sample:`hello_world` sample for the board
 ``s32z2xxdc2/s32z270/rtu0`` with:
 
 .. zephyr-app-commands::
@@ -296,7 +296,7 @@
 - ``<core_id>`` is the zero-based core index relative to the RTU on which to
   run the Zephyr application (0, 1, 2 or 3)
 
-For example, to build the :ref:`hello_world` sample for the board
+For example, to build the :zephyr:code-sample:`hello_world` sample for the board
 ``s32z2xxdc2/s32z270/rtu0`` with split-lock core configuration:
 
 .. zephyr-app-commands::
diff --git a/boards/nxp/twr_ke18f/doc/index.rst b/boards/nxp/twr_ke18f/doc/index.rst
index a72227b..4d91e6e 100644
--- a/boards/nxp/twr_ke18f/doc/index.rst
+++ b/boards/nxp/twr_ke18f/doc/index.rst
@@ -193,7 +193,7 @@
 Flashing
 ========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -211,7 +211,7 @@
 Debugging
 =========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/nxp/twr_kv58f220m/doc/index.rst b/boards/nxp/twr_kv58f220m/doc/index.rst
index 98cc3a8..f9adc60 100644
--- a/boards/nxp/twr_kv58f220m/doc/index.rst
+++ b/boards/nxp/twr_kv58f220m/doc/index.rst
@@ -148,7 +148,7 @@
 Flashing
 ========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -166,7 +166,7 @@
 Debugging
 =========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/nxp/usb_kw24d512/doc/index.rst b/boards/nxp/usb_kw24d512/doc/index.rst
index b617edc..37bbb88 100644
--- a/boards/nxp/usb_kw24d512/doc/index.rst
+++ b/boards/nxp/usb_kw24d512/doc/index.rst
@@ -170,7 +170,7 @@
 Flashing
 ========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -196,7 +196,7 @@
 Debugging
 =========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/nxp/vmu_rt1170/doc/index.rst b/boards/nxp/vmu_rt1170/doc/index.rst
index fa0327c..4ad7bad 100644
--- a/boards/nxp/vmu_rt1170/doc/index.rst
+++ b/boards/nxp/vmu_rt1170/doc/index.rst
@@ -507,7 +507,7 @@
 Flashing
 ========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -524,7 +524,7 @@
 Debugging
 =========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/olimex/olimex_esp32_evb/doc/index.rst b/boards/olimex/olimex_esp32_evb/doc/index.rst
index f904861..5af913a 100644
--- a/boards/olimex/olimex_esp32_evb/doc/index.rst
+++ b/boards/olimex/olimex_esp32_evb/doc/index.rst
@@ -205,7 +205,7 @@
    :goals: build
 
 The usual ``flash`` target will work with the ``olimex_esp32_evb`` board
-configuration. Here is an example for the :ref:`hello_world`
+configuration. Here is an example for the :zephyr:code-sample:`hello_world`
 application.
 
 .. zephyr-app-commands::
@@ -238,7 +238,7 @@
 ``-DOPENOCD=<path/to/bin/openocd> -DOPENOCD_DEFAULT_PATH=<path/to/openocd/share/openocd/scripts>``
 parameter when building.
 
-Here is an example for building the :ref:`hello_world` application.
+Here is an example for building the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -246,7 +246,7 @@
    :goals: build flash
    :gen-args: -DOPENOCD=<path/to/bin/openocd> -DOPENOCD_DEFAULT_PATH=<path/to/openocd/share/openocd/scripts>
 
-You can debug an application in the usual way. Here is an example for the :ref:`hello_world` application.
+You can debug an application in the usual way. Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/olimex/stm32_e407/doc/index.rst b/boards/olimex/stm32_e407/doc/index.rst
index 6abdc3b..6af85cf 100644
--- a/boards/olimex/stm32_e407/doc/index.rst
+++ b/boards/olimex/stm32_e407/doc/index.rst
@@ -336,7 +336,7 @@
 Connect the ST-Link USB dongle to your host computer and to the JTAG port of
 the OLIMEX-STM32-E407 board. Then build and flash an application.
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -360,7 +360,7 @@
 =========
 
 Provided that you have a JTAG probe, you can debug an application in the usual
-way.  Here is an example for the :ref:`hello_world` application.
+way.  Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/olimex/stm32_h103/doc/index.rst b/boards/olimex/stm32_h103/doc/index.rst
index 3abfb3b..291b34b 100644
--- a/boards/olimex/stm32_h103/doc/index.rst
+++ b/boards/olimex/stm32_h103/doc/index.rst
@@ -219,7 +219,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/olimex/stm32_h405/doc/index.rst b/boards/olimex/stm32_h405/doc/index.rst
index ab05134..ff3c8b2 100644
--- a/boards/olimex/stm32_h405/doc/index.rst
+++ b/boards/olimex/stm32_h405/doc/index.rst
@@ -171,7 +171,7 @@
 Flashing an application to the Olimex-STM32-H405
 ================================================
 
-The sample application :ref:`hello_world` is being used in this tutorial.
+The sample application :zephyr:code-sample:`hello_world` is being used in this tutorial.
 
 Connect the ST-Link USB dongle to your host computer and to the JTAG port of
 the OLIMEX-STM32-H405 board.
@@ -201,7 +201,7 @@
 =========
 
 You can debug an application in the usual way. Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/olimex/stm32_h407/doc/index.rst b/boards/olimex/stm32_h407/doc/index.rst
index 3555ed5..114543e 100644
--- a/boards/olimex/stm32_h407/doc/index.rst
+++ b/boards/olimex/stm32_h407/doc/index.rst
@@ -332,7 +332,7 @@
 Connect the ARM-USB-OCD-H debugger to your host computer and to the JTAG port
 of the OLIMEX-STM32-H407 board. Then build and flash an application.
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -357,7 +357,7 @@
 =========
 
 Provided that you have a JTAG probe, you can debug an application in the usual
-way.  Here is an example for the :ref:`hello_world` application.
+way.  Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/olimex/stm32_p405/doc/index.rst b/boards/olimex/stm32_p405/doc/index.rst
index e68bcb5..c754213 100644
--- a/boards/olimex/stm32_p405/doc/index.rst
+++ b/boards/olimex/stm32_p405/doc/index.rst
@@ -216,7 +216,7 @@
 Flashing an application to the Olimex-STM32-P405
 ================================================
 
-The sample application :ref:`hello_world` is being used in this tutorial.
+The sample application :zephyr:code-sample:`hello_world` is being used in this tutorial.
 
 Connect the ST-Link USB dongle to your host computer and to the JTAG port of
 the OLIMEX-STM32-P405 board.
@@ -245,7 +245,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/openisa/rv32m1_vega/doc/index.rst b/boards/openisa/rv32m1_vega/doc/index.rst
index 339b8dc..92d9e99 100644
--- a/boards/openisa/rv32m1_vega/doc/index.rst
+++ b/boards/openisa/rv32m1_vega/doc/index.rst
@@ -577,7 +577,7 @@
    The above only sets these variables for your current shell session.
    You need to make sure this happens every time you use this board.
 
-Now let's compile the :ref:`hello_world` application. (You can try
+Now let's compile the :zephyr:code-sample:`hello_world` application. (You can try
 others as well; see :ref:`samples-and-demos` for more.)
 
 .. We can't use zephyr-app-commands to provide build instructions
diff --git a/boards/others/black_f407ve/doc/index.rst b/boards/others/black_f407ve/doc/index.rst
index a338e7c..cffdd4d 100644
--- a/boards/others/black_f407ve/doc/index.rst
+++ b/boards/others/black_f407ve/doc/index.rst
@@ -222,7 +222,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/others/black_f407zg_pro/doc/index.rst b/boards/others/black_f407zg_pro/doc/index.rst
index 1ca764c..4857e8b 100644
--- a/boards/others/black_f407zg_pro/doc/index.rst
+++ b/boards/others/black_f407zg_pro/doc/index.rst
@@ -204,7 +204,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/others/icev_wireless/doc/index.rst b/boards/others/icev_wireless/doc/index.rst
index 32598b6..5b56cd9 100644
--- a/boards/others/icev_wireless/doc/index.rst
+++ b/boards/others/icev_wireless/doc/index.rst
@@ -224,7 +224,7 @@
 ``-DOPENOCD=<path/to/bin/openocd> -DOPENOCD_DEFAULT_PATH=<path/to/openocd/share/openocd/scripts>``
 parameter when building.
 
-Here is an example for building the :ref:`hello_world` application.
+Here is an example for building the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -233,7 +233,7 @@
    :gen-args: -DOPENOCD=<path/to/bin/openocd> -DOPENOCD_DEFAULT_PATH=<path/to/openocd/share/openocd/scripts>
 
 You can debug an application in the usual way. Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/others/neorv32/doc/index.rst b/boards/others/neorv32/doc/index.rst
index 6626c24..a2dedba 100644
--- a/boards/others/neorv32/doc/index.rst
+++ b/boards/others/neorv32/doc/index.rst
@@ -121,7 +121,7 @@
 Flashing via JTAG
 =================
 
-Here is an example for building and flashing the :ref:`hello_world` application
+Here is an example for building and flashing the :zephyr:code-sample:`hello_world` application
 for the NEORV32 via JTAG. Flashing via JTAG requires a NEORV32 SoC
 implementation with the On-Chip Debugger (OCD) and bootloader enabled.
 
@@ -185,7 +185,7 @@
 Debugging via JTAG
 ==================
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/others/stm32_min_dev/doc/index.rst b/boards/others/stm32_min_dev/doc/index.rst
index 61caf67..e27ea5c 100644
--- a/boards/others/stm32_min_dev/doc/index.rst
+++ b/boards/others/stm32_min_dev/doc/index.rst
@@ -172,7 +172,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/particle/argon/doc/index.rst b/boards/particle/argon/doc/index.rst
index 2bbb15a..0cfedf9 100644
--- a/boards/particle/argon/doc/index.rst
+++ b/boards/particle/argon/doc/index.rst
@@ -145,7 +145,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/particle/boron/doc/index.rst b/boards/particle/boron/doc/index.rst
index d5b7ce1..da87b14 100644
--- a/boards/particle/boron/doc/index.rst
+++ b/boards/particle/boron/doc/index.rst
@@ -141,7 +141,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/particle/nrf51_blenano/doc/index.rst b/boards/particle/nrf51_blenano/doc/index.rst
index 4caae40..1d6d2ea 100644
--- a/boards/particle/nrf51_blenano/doc/index.rst
+++ b/boards/particle/nrf51_blenano/doc/index.rst
@@ -79,7 +79,7 @@
    properly solder headers and assemble the DAPLink and BLE Nano boards.
 
 Now build and flash applications as usual. Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -91,7 +91,7 @@
 
 After mounting the BLE Nano on its DAPLink board as described above,
 you can debug an application in the usual way. Here is an example for
-the :ref:`hello_world` application.
+the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/particle/nrf52_blenano2/doc/index.rst b/boards/particle/nrf52_blenano2/doc/index.rst
index 6c32b4f..b2d0824 100644
--- a/boards/particle/nrf52_blenano2/doc/index.rst
+++ b/boards/particle/nrf52_blenano2/doc/index.rst
@@ -77,7 +77,7 @@
    connector.
 
 Now build and flash applications as usual. Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -89,7 +89,7 @@
 
 After mounting the BLE Nano 2 on its DAPLink board as described above,
 you can debug an application in the usual way.  Here is an example for
-the :ref:`hello_world` application.
+the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/particle/xenon/doc/index.rst b/boards/particle/xenon/doc/index.rst
index cf18340..d28b8aa 100644
--- a/boards/particle/xenon/doc/index.rst
+++ b/boards/particle/xenon/doc/index.rst
@@ -146,7 +146,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/phytec/mimx8mp_phyboard_pollux/doc/index.rst b/boards/phytec/mimx8mp_phyboard_pollux/doc/index.rst
index b9643a3..6314b71 100644
--- a/boards/phytec/mimx8mp_phyboard_pollux/doc/index.rst
+++ b/boards/phytec/mimx8mp_phyboard_pollux/doc/index.rst
@@ -215,7 +215,7 @@
 
    u-boot=> bootaux 0x7e0000
 
-Here is an example for the :ref:`hello_world` application:
+Here is an example for the :zephyr:code-sample:`hello_world` application:
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/phytec/phyboard_electra/doc/index.rst b/boards/phytec/phyboard_electra/doc/index.rst
index 372f8d3..9af3400 100644
--- a/boards/phytec/phyboard_electra/doc/index.rst
+++ b/boards/phytec/phyboard_electra/doc/index.rst
@@ -104,7 +104,7 @@
 Therefore, the testing requires the binary to be copied to the SD card to allow the A53 cores to
 load it while booting using remoteproc.
 
-To test the M4F core, we build the :ref:`hello_world` sample with the following command.
+To test the M4F core, we build the :zephyr:code-sample:`hello_world` sample with the following command.
 
 .. zephyr-app-commands::
    :board: phyboard_electra/am6442/m4
diff --git a/boards/phytec/phyboard_lyra/doc/phyboard_lyra_am62xx_a53.rst b/boards/phytec/phyboard_lyra/doc/phyboard_lyra_am62xx_a53.rst
index 410debf..9b6d2f4 100644
--- a/boards/phytec/phyboard_lyra/doc/phyboard_lyra_am62xx_a53.rst
+++ b/boards/phytec/phyboard_lyra/doc/phyboard_lyra_am62xx_a53.rst
@@ -80,7 +80,7 @@
 
 You can build an application in the usual way. Refer to
 :ref:`build_an_application` for more details. Here is an example for
-:ref:`hello_world`.
+:zephyr:code-sample:`hello_world`.
 
 .. zephyr-app-commands::
    :board: phyboard_lyra/am6234/a53
diff --git a/boards/phytec/phyboard_lyra/doc/phyboard_lyra_am62xx_m4.rst b/boards/phytec/phyboard_lyra/doc/phyboard_lyra_am62xx_m4.rst
index 55d49395..d0f6126 100644
--- a/boards/phytec/phyboard_lyra/doc/phyboard_lyra_am62xx_m4.rst
+++ b/boards/phytec/phyboard_lyra/doc/phyboard_lyra_am62xx_m4.rst
@@ -96,7 +96,7 @@
 Therefore, the testing requires the binary to be copied to the SD card to allow the A53 cores to
 load it while booting using remoteproc.
 
-To test the M4F core, we build the :ref:`hello_world` sample with the following command.
+To test the M4F core, we build the :zephyr:code-sample:`hello_world` sample with the following command.
 
 .. code-block:: console
 
diff --git a/boards/phytec/reel_board/doc/index.rst b/boards/phytec/reel_board/doc/index.rst
index 79001a0..d468a6c 100644
--- a/boards/phytec/reel_board/doc/index.rst
+++ b/boards/phytec/reel_board/doc/index.rst
@@ -497,7 +497,7 @@
 applications as usual (see :ref:`build_an_application` and
 :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 First, run your favorite terminal program to listen for output.
 
@@ -528,7 +528,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/qorvo/decawave_dwm1001_dev/doc/index.rst b/boards/qorvo/decawave_dwm1001_dev/doc/index.rst
index 4699de8..93966ed 100644
--- a/boards/qorvo/decawave_dwm1001_dev/doc/index.rst
+++ b/boards/qorvo/decawave_dwm1001_dev/doc/index.rst
@@ -31,7 +31,7 @@
 applications as usual (see :ref:`build_an_application` and
 :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 First, run your favorite terminal program to listen for output.
 
diff --git a/boards/rak/rak11720/doc/index.rst b/boards/rak/rak11720/doc/index.rst
index ff8e90a..238ba6d 100644
--- a/boards/rak/rak11720/doc/index.rst
+++ b/boards/rak/rak11720/doc/index.rst
@@ -83,7 +83,7 @@
 -----------------------
 
 Connect your device to your host computer using the JLINK USB port.
-The sample application :ref:`hello_world` is used for this example.
+The sample application :zephyr:code-sample:`hello_world` is used for this example.
 Build the Zephyr kernel and application, then flash it to the device:
 
 .. zephyr-app-commands::
diff --git a/boards/rak/rak4631/doc/index.rst b/boards/rak/rak4631/doc/index.rst
index ffa39ca..14c6c91 100644
--- a/boards/rak/rak4631/doc/index.rst
+++ b/boards/rak/rak4631/doc/index.rst
@@ -121,7 +121,7 @@
    - Stop bits: 1
 
 #. Connect the RAK4631 board to your host computer using the USB debug port.
-   Then build and flash the :ref:`hello_world` application.
+   Then build and flash the :zephyr:code-sample:`hello_world` application.
 
    .. zephyr-app-commands::
       :zephyr-app: samples/hello_world
@@ -134,7 +134,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/rak/rak5010/doc/index.rst b/boards/rak/rak5010/doc/index.rst
index fac00cf..851d892 100644
--- a/boards/rak/rak5010/doc/index.rst
+++ b/boards/rak/rak5010/doc/index.rst
@@ -126,7 +126,7 @@
    - Stop bits: 1
 
 #. Connect the RAK5010 board to your host computer using the USB debug port.
-   Then build and flash the :ref:`hello_world` application.
+   Then build and flash the :zephyr:code-sample:`hello_world` application.
 
    .. zephyr-app-commands::
       :zephyr-app: samples/hello_world
@@ -139,7 +139,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/raspberrypi/rpi_5/doc/index.rst b/boards/raspberrypi/rpi_5/doc/index.rst
index 1c63e5a..fd0ad27 100644
--- a/boards/raspberrypi/rpi_5/doc/index.rst
+++ b/boards/raspberrypi/rpi_5/doc/index.rst
@@ -126,7 +126,7 @@
 zephyr.bin
 ----------
 
-Build an app, for example :ref:`hello_world`:
+Build an app, for example :zephyr:code-sample:`hello_world`:
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/raytac/mdbt50q_db_33/doc/index.rst b/boards/raytac/mdbt50q_db_33/doc/index.rst
index b078dd2..8089b7b 100644
--- a/boards/raytac/mdbt50q_db_33/doc/index.rst
+++ b/boards/raytac/mdbt50q_db_33/doc/index.rst
@@ -147,7 +147,7 @@
 applications as usual (see :ref:`build_an_application` and
 :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 Use a USB to TTL converter to connect the computer and raytac_mdbt50q_db_33/nrf52833
 J10 connector. Then run your favorite terminal program to listen for output.
diff --git a/boards/raytac/mdbt50q_db_40/doc/index.rst b/boards/raytac/mdbt50q_db_40/doc/index.rst
index f9d7981..269b42b 100644
--- a/boards/raytac/mdbt50q_db_40/doc/index.rst
+++ b/boards/raytac/mdbt50q_db_40/doc/index.rst
@@ -149,7 +149,7 @@
 applications as usual (see :ref:`build_an_application` and
 :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 Use a USB to TTL converter to connect the computer and raytac_mdbt50q_db_40/nrf52840
 J10 connector. Then run your favorite terminal program to listen for output.
diff --git a/boards/raytac/mdbt53_db_40/doc/index.rst b/boards/raytac/mdbt53_db_40/doc/index.rst
index a57fc52..9ddb5b7 100644
--- a/boards/raytac/mdbt53_db_40/doc/index.rst
+++ b/boards/raytac/mdbt53_db_40/doc/index.rst
@@ -225,7 +225,7 @@
    If you are flashing with :ref:`west <west-build-flash-debug>`, run
    this command for more details on the related ``--recover`` option:
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 Use a USB to TTL converter to connect the computer and raytac_mdbt53_db_40_nrf5340
 J10 connector. Then run your favorite terminal program to listen for output.
diff --git a/boards/raytac/mdbt53v_db_40/doc/index.rst b/boards/raytac/mdbt53v_db_40/doc/index.rst
index ca38f03..27a2aee 100644
--- a/boards/raytac/mdbt53v_db_40/doc/index.rst
+++ b/boards/raytac/mdbt53v_db_40/doc/index.rst
@@ -218,7 +218,7 @@
 applications as usual (see :ref:`build_an_application` and
 :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 Use a USB to TTL converter to connect the computer and raytac_mdbt53v_db_40_nrf5340
 J13 connector pin 8(RX), 9(TX) and GND. Then run your favorite terminal program to listen for output.
diff --git a/boards/renesas/rcar_h3ulcb/doc/rcar_h3ulcb_r7.rst b/boards/renesas/rcar_h3ulcb/doc/rcar_h3ulcb_r7.rst
index 5fcd4fa..f77c161 100644
--- a/boards/renesas/rcar_h3ulcb/doc/rcar_h3ulcb_r7.rst
+++ b/boards/renesas/rcar_h3ulcb/doc/rcar_h3ulcb_r7.rst
@@ -224,7 +224,7 @@
 
 First of all, open your serial terminal.
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/renesas/rcar_salvator_x/doc/rcar_salvator_x.rst b/boards/renesas/rcar_salvator_x/doc/rcar_salvator_x.rst
index e95049a..3e7b577 100644
--- a/boards/renesas/rcar_salvator_x/doc/rcar_salvator_x.rst
+++ b/boards/renesas/rcar_salvator_x/doc/rcar_salvator_x.rst
@@ -147,7 +147,7 @@
 
 First of all, open your serial terminal.
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/renesas/rcar_spider_s4/doc/rcar_spider_a55.rst b/boards/renesas/rcar_spider_s4/doc/rcar_spider_a55.rst
index 2f45cf1..b66975a 100644
--- a/boards/renesas/rcar_spider_s4/doc/rcar_spider_a55.rst
+++ b/boards/renesas/rcar_spider_s4/doc/rcar_spider_a55.rst
@@ -63,7 +63,7 @@
    tftp 0x48000000 <tftp_server_path/zephyr.bin>
    booti 0x48000000
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/renesas/rcar_spider_s4/doc/rcar_spider_r52.rst b/boards/renesas/rcar_spider_s4/doc/rcar_spider_r52.rst
index d7fec18..9c7be4d 100644
--- a/boards/renesas/rcar_spider_s4/doc/rcar_spider_r52.rst
+++ b/boards/renesas/rcar_spider_s4/doc/rcar_spider_r52.rst
@@ -161,7 +161,7 @@
 
 First of all, open your serial terminal.
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/sc/scobc_module1/doc/index.rst b/boards/sc/scobc_module1/doc/index.rst
index fd6f82e..260a062 100644
--- a/boards/sc/scobc_module1/doc/index.rst
+++ b/boards/sc/scobc_module1/doc/index.rst
@@ -73,7 +73,7 @@
 Here is an example for building and flashing the \`hello\_world\`
 application for the board:
 
-Here is an example for building and flashing the :ref:`hello_world` application
+Here is an example for building and flashing the :zephyr:code-sample:`hello_world` application
 for the default design:
 
 .. zephyr-app-commands::
@@ -94,7 +94,7 @@
 Debugging
 =========
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/seco/stm32f3_seco_d23/doc/index.rst b/boards/seco/stm32f3_seco_d23/doc/index.rst
index 17be6bc..bc26267 100644
--- a/boards/seco/stm32f3_seco_d23/doc/index.rst
+++ b/boards/seco/stm32f3_seco_d23/doc/index.rst
@@ -208,7 +208,7 @@
 
 Then build and flash your application.
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/seeed/lora_e5_dev_board/doc/lora_e5_dev_board.rst b/boards/seeed/lora_e5_dev_board/doc/lora_e5_dev_board.rst
index 8d96f1e..ca23421 100644
--- a/boards/seeed/lora_e5_dev_board/doc/lora_e5_dev_board.rst
+++ b/boards/seeed/lora_e5_dev_board/doc/lora_e5_dev_board.rst
@@ -242,7 +242,7 @@
 
 Connect the LoRa-E5 to your host computer using the external debug probe.
 Then build and flash an application. Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 Run a serial host program to connect with your board:
 Per default the console on ``usart1`` is available on the USB Type C connector
diff --git a/boards/seeed/lora_e5_mini/doc/index.rst b/boards/seeed/lora_e5_mini/doc/index.rst
index 7f36a92..78227fc 100644
--- a/boards/seeed/lora_e5_mini/doc/index.rst
+++ b/boards/seeed/lora_e5_mini/doc/index.rst
@@ -178,7 +178,7 @@
 
 Connect the LoRa-E5 to your host computer using the external debug probe.
 Then build and flash an application. Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 Run a serial host program to connect with your board:
 Per default the console on ``usart1`` is available on the USB Type C connector
diff --git a/boards/seeed/seeeduino_xiao/doc/index.rst b/boards/seeed/seeeduino_xiao/doc/index.rst
index aa11b81..8f36149 100644
--- a/boards/seeed/seeeduino_xiao/doc/index.rst
+++ b/boards/seeed/seeeduino_xiao/doc/index.rst
@@ -120,7 +120,7 @@
 Flashing
 ========
 
-#. Build the Zephyr kernel and the :ref:`hello_world` sample application:
+#. Build the Zephyr kernel and the :zephyr:code-sample:`hello_world` sample application:
 
    .. zephyr-app-commands::
       :zephyr-app: samples/hello_world
diff --git a/boards/seeed/xiao_ble/doc/index.rst b/boards/seeed/xiao_ble/doc/index.rst
index d91729d..c33d786 100644
--- a/boards/seeed/xiao_ble/doc/index.rst
+++ b/boards/seeed/xiao_ble/doc/index.rst
@@ -117,7 +117,7 @@
 usual (see :ref:`build_an_application` and :ref:`application_run` for more
 details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 First, run your favorite terminal program to listen for output.
 
diff --git a/boards/seeed/xiao_esp32c3/doc/index.rst b/boards/seeed/xiao_esp32c3/doc/index.rst
index e834663..48ce9dd 100644
--- a/boards/seeed/xiao_esp32c3/doc/index.rst
+++ b/boards/seeed/xiao_esp32c3/doc/index.rst
@@ -198,7 +198,7 @@
 ``-DOPENOCD=<path/to/bin/openocd> -DOPENOCD_DEFAULT_PATH=<path/to/openocd/share/openocd/scripts>``
 parameter when building.
 
-Here is an example for building the :ref:`hello_world` application.
+Here is an example for building the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -206,7 +206,7 @@
    :goals: build flash
    :gen-args: -DOPENOCD=<path/to/bin/openocd> -DOPENOCD_DEFAULT_PATH=<path/to/openocd/share/openocd/scripts>
 
-You can debug an application in the usual way. Here is an example for the :ref:`hello_world` application.
+You can debug an application in the usual way. Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/seeed/xiao_esp32s3/doc/index.rst b/boards/seeed/xiao_esp32s3/doc/index.rst
index 7f830f6..4c029bd 100644
--- a/boards/seeed/xiao_esp32s3/doc/index.rst
+++ b/boards/seeed/xiao_esp32s3/doc/index.rst
@@ -189,7 +189,7 @@
    :goals: build
 
 The usual ``flash`` target will work with the ``xiao_esp32s3`` board
-configuration. Here is an example for the :ref:`hello_world`
+configuration. Here is an example for the :zephyr:code-sample:`hello_world`
 application.
 
 .. zephyr-app-commands::
@@ -220,14 +220,14 @@
 
 Further documentation can be obtained from the SoC vendor in `JTAG debugging for ESP32-S3`_.
 
-Here is an example for building the :ref:`hello_world` application.
+Here is an example for building the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
    :board: xiao_esp32s3/esp32/procpu
    :goals: build flash
 
-You can debug an application in the usual way. Here is an example for the :ref:`hello_world` application.
+You can debug an application in the usual way. Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/silabs/dev_kits/sim3u1xx_dk/doc/index.rst b/boards/silabs/dev_kits/sim3u1xx_dk/doc/index.rst
index 14d176b..67284c4 100644
--- a/boards/silabs/dev_kits/sim3u1xx_dk/doc/index.rst
+++ b/boards/silabs/dev_kits/sim3u1xx_dk/doc/index.rst
@@ -98,7 +98,7 @@
 Flashing
 ========
 
-The sample application :ref:`hello_world` is used for this example. Build the Zephyr kernel and
+The sample application :zephyr:code-sample:`hello_world` is used for this example. Build the Zephyr kernel and
 application:
 
 .. zephyr-app-commands::
diff --git a/boards/silabs/dev_kits/sltb004a/doc/index.rst b/boards/silabs/dev_kits/sltb004a/doc/index.rst
index 8ee2b64..e111453 100644
--- a/boards/silabs/dev_kits/sltb004a/doc/index.rst
+++ b/boards/silabs/dev_kits/sltb004a/doc/index.rst
@@ -165,7 +165,7 @@
 Flashing an application to SLTB004A
 -----------------------------------
 
-The sample application :ref:`hello_world` is used for this example.
+The sample application :zephyr:code-sample:`hello_world` is used for this example.
 Build the Zephyr kernel and application:
 
 .. zephyr-app-commands::
diff --git a/boards/silabs/dev_kits/sltb009a/doc/index.rst b/boards/silabs/dev_kits/sltb009a/doc/index.rst
index 2ec7a83..9366a7d 100644
--- a/boards/silabs/dev_kits/sltb009a/doc/index.rst
+++ b/boards/silabs/dev_kits/sltb009a/doc/index.rst
@@ -126,7 +126,7 @@
 
 Connect the SLTB009A to your host computer using the USB port.
 
-Here is an example to build and flash the :ref:`hello_world` application.
+Here is an example to build and flash the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/silabs/dev_kits/sltb010a/doc/index.rst b/boards/silabs/dev_kits/sltb010a/doc/index.rst
index bbca08c..a335924 100644
--- a/boards/silabs/dev_kits/sltb010a/doc/index.rst
+++ b/boards/silabs/dev_kits/sltb010a/doc/index.rst
@@ -131,7 +131,7 @@
 -----------------------
 
 Connect your device to your host computer using the USB port.
-The sample application :ref:`hello_world` is used for this example.
+The sample application :zephyr:code-sample:`hello_world` is used for this example.
 Build the Zephyr kernel and application, then flash it to the device:
 
 BRD4184A:
diff --git a/boards/silabs/dev_kits/xg24_dk2601b/doc/index.rst b/boards/silabs/dev_kits/xg24_dk2601b/doc/index.rst
index c5ec0f6..069b1d8 100644
--- a/boards/silabs/dev_kits/xg24_dk2601b/doc/index.rst
+++ b/boards/silabs/dev_kits/xg24_dk2601b/doc/index.rst
@@ -124,7 +124,7 @@
 Flashing
 ========
 
-The sample application :ref:`hello_world` is used for this example.
+The sample application :zephyr:code-sample:`hello_world` is used for this example.
 Build the Zephyr kernel and application:
 
 .. zephyr-app-commands::
diff --git a/boards/silabs/dev_kits/xg27_dk2602a/doc/index.rst b/boards/silabs/dev_kits/xg27_dk2602a/doc/index.rst
index abaafbf..273b78e 100644
--- a/boards/silabs/dev_kits/xg27_dk2602a/doc/index.rst
+++ b/boards/silabs/dev_kits/xg27_dk2602a/doc/index.rst
@@ -105,7 +105,7 @@
 Programming and Debugging
 =========================
 
-The sample application :ref:`hello_world` is used for this example.
+The sample application :zephyr:code-sample:`hello_world` is used for this example.
 Build the Zephyr kernel and application:
 
 .. zephyr-app-commands::
diff --git a/boards/silabs/radio_boards/slwrb4104a/doc/index.rst b/boards/silabs/radio_boards/slwrb4104a/doc/index.rst
index 6522489..3496421 100644
--- a/boards/silabs/radio_boards/slwrb4104a/doc/index.rst
+++ b/boards/silabs/radio_boards/slwrb4104a/doc/index.rst
@@ -128,7 +128,7 @@
 Connect the BRD4001A board with a mounted BRD4104A radio module to your host
 computer using the USB port.
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/silabs/radio_boards/slwrb4161a/doc/index.rst b/boards/silabs/radio_boards/slwrb4161a/doc/index.rst
index 1f09e7d..927e27c 100644
--- a/boards/silabs/radio_boards/slwrb4161a/doc/index.rst
+++ b/boards/silabs/radio_boards/slwrb4161a/doc/index.rst
@@ -122,7 +122,7 @@
 Connect the BRD4001A board with a mounted BRD4161A radio module to your host
 computer using the USB port.
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/silabs/radio_boards/slwrb4170a/doc/index.rst b/boards/silabs/radio_boards/slwrb4170a/doc/index.rst
index b6a29d1..ccc2b72 100644
--- a/boards/silabs/radio_boards/slwrb4170a/doc/index.rst
+++ b/boards/silabs/radio_boards/slwrb4170a/doc/index.rst
@@ -122,7 +122,7 @@
 Connect the BRD4001A board with a mounted BRD4170A radio module to your host
 computer using the USB port.
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/silabs/radio_boards/slwrb4180a/doc/index.rst b/boards/silabs/radio_boards/slwrb4180a/doc/index.rst
index 01864a5..057e8ec 100644
--- a/boards/silabs/radio_boards/slwrb4180a/doc/index.rst
+++ b/boards/silabs/radio_boards/slwrb4180a/doc/index.rst
@@ -119,7 +119,7 @@
 Connect the BRD4001A board with a mounted BRD4180A radio module to your host
 computer using the USB port.
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/silabs/radio_boards/slwrb4250b/doc/index.rst b/boards/silabs/radio_boards/slwrb4250b/doc/index.rst
index 59a38cf..7a865b5 100644
--- a/boards/silabs/radio_boards/slwrb4250b/doc/index.rst
+++ b/boards/silabs/radio_boards/slwrb4250b/doc/index.rst
@@ -126,7 +126,7 @@
 Connect the BRD4001A board with a mounted BRD4250B radio module to your host
 computer using the USB port.
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/silabs/radio_boards/slwrb4255a/doc/index.rst b/boards/silabs/radio_boards/slwrb4255a/doc/index.rst
index d7e303c..43dd6e6 100644
--- a/boards/silabs/radio_boards/slwrb4255a/doc/index.rst
+++ b/boards/silabs/radio_boards/slwrb4255a/doc/index.rst
@@ -122,7 +122,7 @@
 Connect the BRD4001A board with a mounted BRD4255A radio module to your host
 computer using the USB port.
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/silabs/radio_boards/slwrb4321a/doc/index.rst b/boards/silabs/radio_boards/slwrb4321a/doc/index.rst
index 1170205..50ec07b 100644
--- a/boards/silabs/radio_boards/slwrb4321a/doc/index.rst
+++ b/boards/silabs/radio_boards/slwrb4321a/doc/index.rst
@@ -137,7 +137,7 @@
 
 Connect the SLWSTK6121A to your host computer using the USB port.
 
-Here is an example to build and flash the :ref:`hello_world` application.
+Here is an example to build and flash the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/silabs/radio_boards/xg24_rb4187c/doc/index.rst b/boards/silabs/radio_boards/xg24_rb4187c/doc/index.rst
index 5100a4b..82da558 100644
--- a/boards/silabs/radio_boards/xg24_rb4187c/doc/index.rst
+++ b/boards/silabs/radio_boards/xg24_rb4187c/doc/index.rst
@@ -120,7 +120,7 @@
 Connect the BRD4002A board with a mounted BRD4187C radio module to your host
 computer using the USB port.
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/silabs/starter_kits/efm32wg_stk3800/doc/index.rst b/boards/silabs/starter_kits/efm32wg_stk3800/doc/index.rst
index 139d893..0c04b7b 100644
--- a/boards/silabs/starter_kits/efm32wg_stk3800/doc/index.rst
+++ b/boards/silabs/starter_kits/efm32wg_stk3800/doc/index.rst
@@ -125,7 +125,7 @@
 Flashing an application to EFM32-STK3800
 ----------------------------------------
 
-The sample application :ref:`hello_world` is used for this example.
+The sample application :zephyr:code-sample:`hello_world` is used for this example.
 Build the Zephyr kernel and application:
 
 .. zephyr-app-commands::
diff --git a/boards/silabs/starter_kits/slstk3400a/doc/index.rst b/boards/silabs/starter_kits/slstk3400a/doc/index.rst
index a48cc3f..7f3f919 100644
--- a/boards/silabs/starter_kits/slstk3400a/doc/index.rst
+++ b/boards/silabs/starter_kits/slstk3400a/doc/index.rst
@@ -125,7 +125,7 @@
 Flashing an application to EFM32-SLSTK3400A
 -------------------------------------------
 
-The sample application :ref:`hello_world` is used for this example.
+The sample application :zephyr:code-sample:`hello_world` is used for this example.
 Build the Zephyr kernel and application:
 
 .. zephyr-app-commands::
diff --git a/boards/silabs/starter_kits/slstk3401a/doc/index.rst b/boards/silabs/starter_kits/slstk3401a/doc/index.rst
index 2de4948..d1e41ad 100644
--- a/boards/silabs/starter_kits/slstk3401a/doc/index.rst
+++ b/boards/silabs/starter_kits/slstk3401a/doc/index.rst
@@ -136,7 +136,7 @@
 Flashing an application to SLSTK3401A
 -------------------------------------
 
-The sample application :ref:`hello_world` is used for this example.
+The sample application :zephyr:code-sample:`hello_world` is used for this example.
 Build the Zephyr kernel and application:
 
 .. zephyr-app-commands::
diff --git a/boards/silabs/starter_kits/slstk3402a/doc/index.rst b/boards/silabs/starter_kits/slstk3402a/doc/index.rst
index 8d6193e..4e5293e 100644
--- a/boards/silabs/starter_kits/slstk3402a/doc/index.rst
+++ b/boards/silabs/starter_kits/slstk3402a/doc/index.rst
@@ -159,7 +159,7 @@
 Flashing an application to SLSTK3402A
 -------------------------------------
 
-The sample application :ref:`hello_world` is used for this example.
+The sample application :zephyr:code-sample:`hello_world` is used for this example.
 Build the Zephyr kernel and application:
 
 .. zephyr-app-commands::
diff --git a/boards/silabs/starter_kits/slstk3701a/doc/index.rst b/boards/silabs/starter_kits/slstk3701a/doc/index.rst
index d270bf3..6209984 100644
--- a/boards/silabs/starter_kits/slstk3701a/doc/index.rst
+++ b/boards/silabs/starter_kits/slstk3701a/doc/index.rst
@@ -148,7 +148,7 @@
 Flashing an application to SLSTK3701A
 -------------------------------------
 
-The sample application :ref:`hello_world` is used for this example.
+The sample application :zephyr:code-sample:`hello_world` is used for this example.
 Build the Zephyr kernel and application:
 
 .. zephyr-app-commands::
diff --git a/boards/snps/em_starterkit/doc/index.rst b/boards/snps/em_starterkit/doc/index.rst
index 4390ab2..e569031 100644
--- a/boards/snps/em_starterkit/doc/index.rst
+++ b/boards/snps/em_starterkit/doc/index.rst
@@ -173,7 +173,7 @@
 ==============================
 
 You can try many of the sample applications or tests, but let us discuss
-the one called :ref:`hello_world`.
+the one called :zephyr:code-sample:`hello_world`.
 It is found in :zephyr_file:`samples/hello_world`.
 
 Configuring
@@ -201,7 +201,7 @@
 
 You can build application in the usual way.  Refer to
 :ref:`build_an_application` for more details. Here is an example for
-:ref:`hello_world`.
+:zephyr:code-sample:`hello_world`.
 
 .. zephyr-app-commands::
    :board: em_starterkit
diff --git a/boards/snps/emsdp/doc/index.rst b/boards/snps/emsdp/doc/index.rst
index fa4606d..bad8a48 100644
--- a/boards/snps/emsdp/doc/index.rst
+++ b/boards/snps/emsdp/doc/index.rst
@@ -161,7 +161,7 @@
 ==============================
 
 You can try many of the sample applications or tests, but let us discuss
-the one called :ref:`hello_world`.
+the one called :zephyr:code-sample:`hello_world`.
 It is found in :zephyr_file:`samples/hello_world`.
 
 Configuring
@@ -184,7 +184,7 @@
 
 You can build an application in the usual way.  Refer to
 :ref:`build_an_application` for more details. Here is an example for
-:ref:`hello_world` for the em4.
+:zephyr:code-sample:`hello_world` for the em4.
 
 .. zephyr-app-commands::
    :board: emsdp/emsdp_em4
diff --git a/boards/snps/hsdk/doc/index.rst b/boards/snps/hsdk/doc/index.rst
index 5d5fb1a..a7165a2 100644
--- a/boards/snps/hsdk/doc/index.rst
+++ b/boards/snps/hsdk/doc/index.rst
@@ -388,7 +388,7 @@
 ==============================
 
 You can try many of the :ref:`sample applications and demos
-<samples-and-demos>`.  We'll use :ref:`hello_world`, found in
+<samples-and-demos>`.  We'll use :zephyr:code-sample:`hello_world`, found in
 :zephyr_file:`samples/hello_world` as an example.
 
 Configuring
@@ -410,7 +410,7 @@
 
 You can build an application in the usual way.  Refer to
 :ref:`build_an_application` for more details. Here is an example for
-:ref:`hello_world`.
+:zephyr:code-sample:`hello_world`.
 
 .. zephyr-app-commands::
    :board: hsdk
diff --git a/boards/snps/hsdk4xd/doc/index.rst b/boards/snps/hsdk4xd/doc/index.rst
index b373f22..a5cfd53 100644
--- a/boards/snps/hsdk4xd/doc/index.rst
+++ b/boards/snps/hsdk4xd/doc/index.rst
@@ -385,7 +385,7 @@
 ==============================
 
 You can try many of the :ref:`sample applications and demos
-<samples-and-demos>`.  We'll use :ref:`hello_world`, found in
+<samples-and-demos>`.  We'll use :zephyr:code-sample:`hello_world`, found in
 :zephyr_file:`samples/hello_world` as an example.
 
 Configuring
@@ -407,7 +407,7 @@
 
 You can build an application in the usual way.  Refer to
 :ref:`build_an_application` for more details. Here is an example for
-:ref:`hello_world`.
+:zephyr:code-sample:`hello_world`.
 
 .. zephyr-app-commands::
    :board: hsdk4xd
diff --git a/boards/snps/iotdk/doc/index.rst b/boards/snps/iotdk/doc/index.rst
index 8057e85..5482bed 100644
--- a/boards/snps/iotdk/doc/index.rst
+++ b/boards/snps/iotdk/doc/index.rst
@@ -68,7 +68,7 @@
 ==============================
 
 You can try many of the sample applications or tests, but let us discuss
-the one called :ref:`hello_world`.
+the one called :zephyr:code-sample:`hello_world`.
 It is found in :zephyr_file:`samples/hello_world`.
 
 Configuring
@@ -90,7 +90,7 @@
 
 You can build an application in the usual way.  Refer to
 :ref:`build_an_application` for more details. Here is an example for
-:ref:`hello_world`.
+:zephyr:code-sample:`hello_world`.
 
 .. zephyr-app-commands::
    :board: iotdk
diff --git a/boards/sparkfun/micromod/doc/index.rst b/boards/sparkfun/micromod/doc/index.rst
index 294441f..507ef52 100644
--- a/boards/sparkfun/micromod/doc/index.rst
+++ b/boards/sparkfun/micromod/doc/index.rst
@@ -142,7 +142,7 @@
 In the case of `Sparkfun asset tracking carrier`_, it is possible to use
 the SWD interface along with a J-Link.
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 First, run your favorite terminal program to listen for output.
 
diff --git a/boards/sparkfun/thing_plus/doc/index.rst b/boards/sparkfun/thing_plus/doc/index.rst
index 1e9994e..802c77f 100644
--- a/boards/sparkfun/thing_plus/doc/index.rst
+++ b/boards/sparkfun/thing_plus/doc/index.rst
@@ -92,7 +92,7 @@
 or Nordic based examples.
 
 Some of the examples do not use secure mode, so they do not required the ``ns`` suffix.
-A great example of this is the :ref:`hello_world` below.
+A great example of this is the :zephyr:code-sample:`hello_world` below.
 
 Flashing
 ========
@@ -103,7 +103,7 @@
 applications as usual (see :ref:`build_an_application` and
 :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 First, run your favorite terminal program to listen for output.
 
diff --git a/boards/sparkfun/thing_plus_matter_mgm240p/doc/index.rst b/boards/sparkfun/thing_plus_matter_mgm240p/doc/index.rst
index f9ffd1f..cdaed77 100644
--- a/boards/sparkfun/thing_plus_matter_mgm240p/doc/index.rst
+++ b/boards/sparkfun/thing_plus_matter_mgm240p/doc/index.rst
@@ -105,7 +105,7 @@
 Flashing
 ========
 
-The sample application :ref:`hello_world` is used for this example.
+The sample application :zephyr:code-sample:`hello_world` is used for this example.
 Build the Zephyr kernel and application:
 
 .. zephyr-app-commands::
diff --git a/boards/st/b_g474e_dpow1/doc/index.rst b/boards/st/b_g474e_dpow1/doc/index.rst
index 39f7bf0..7e1f584 100644
--- a/boards/st/b_g474e_dpow1/doc/index.rst
+++ b/boards/st/b_g474e_dpow1/doc/index.rst
@@ -137,7 +137,7 @@
 =========
 
 You can debug an application in the usual way. Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/b_l072z_lrwan1/doc/index.rst b/boards/st/b_l072z_lrwan1/doc/index.rst
index 87a98d6..527461c 100644
--- a/boards/st/b_l072z_lrwan1/doc/index.rst
+++ b/boards/st/b_l072z_lrwan1/doc/index.rst
@@ -214,7 +214,7 @@
 Flashing an application to B-L072Z-LRWAN1 Discovery board
 ---------------------------------------------------------
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 Connect the B-L072Z-LRWAN1 Discovery board to a STLinkV2 to your host computer using the USB port, then
 run a serial host program to connect with your board. For example:
@@ -240,7 +240,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/b_l4s5i_iot01a/doc/index.rst b/boards/st/b_l4s5i_iot01a/doc/index.rst
index b66df63..fb1620c 100644
--- a/boards/st/b_l4s5i_iot01a/doc/index.rst
+++ b/boards/st/b_l4s5i_iot01a/doc/index.rst
@@ -205,7 +205,7 @@
    $ minicom -D /dev/ttyACM0
 
 Then, build and flash in the usual way. Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -222,7 +222,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/b_u585i_iot02a/doc/index.rst b/boards/st/b_u585i_iot02a/doc/index.rst
index f09b6f3..2400f75 100644
--- a/boards/st/b_u585i_iot02a/doc/index.rst
+++ b/boards/st/b_u585i_iot02a/doc/index.rst
@@ -317,7 +317,7 @@
    $ minicom -D /dev/ttyACM0
 
 Then, build and flash in the usual way. Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/disco_l475_iot1/doc/index.rst b/boards/st/disco_l475_iot1/doc/index.rst
index a5ba3b5..1978810 100644
--- a/boards/st/disco_l475_iot1/doc/index.rst
+++ b/boards/st/disco_l475_iot1/doc/index.rst
@@ -216,7 +216,7 @@
 Flashing an application to Disco L475 IoT
 -----------------------------------------
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 Connect the Disco L475 IoT to your host computer using the USB port, then
 run a serial host program to connect with your Nucleo board. For example:
@@ -242,7 +242,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/nucleo_f070rb/doc/index.rst b/boards/st/nucleo_f070rb/doc/index.rst
index b017b21..acecfb2 100644
--- a/boards/st/nucleo_f070rb/doc/index.rst
+++ b/boards/st/nucleo_f070rb/doc/index.rst
@@ -169,7 +169,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/nucleo_f091rc/doc/index.rst b/boards/st/nucleo_f091rc/doc/index.rst
index 38cb5e6..2cce144 100644
--- a/boards/st/nucleo_f091rc/doc/index.rst
+++ b/boards/st/nucleo_f091rc/doc/index.rst
@@ -186,7 +186,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/nucleo_f401re/doc/index.rst b/boards/st/nucleo_f401re/doc/index.rst
index ceb2536..123992a 100644
--- a/boards/st/nucleo_f401re/doc/index.rst
+++ b/boards/st/nucleo_f401re/doc/index.rst
@@ -179,7 +179,7 @@
    $ minicom -D /dev/ttyACM0
 
 Now build and flash an application. Here is an example for
-:ref:`hello_world`.
+:zephyr:code-sample:`hello_world`.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -197,7 +197,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/nucleo_f410rb/doc/index.rst b/boards/st/nucleo_f410rb/doc/index.rst
index f260608..af87b50 100644
--- a/boards/st/nucleo_f410rb/doc/index.rst
+++ b/boards/st/nucleo_f410rb/doc/index.rst
@@ -176,7 +176,7 @@
 Flashing an application to Nucleo F410RB
 ----------------------------------------
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 Run a serial host program to connect with your Nucleo board.
 
@@ -201,7 +201,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/nucleo_f411re/doc/index.rst b/boards/st/nucleo_f411re/doc/index.rst
index fb6cf4e..e4c1008 100644
--- a/boards/st/nucleo_f411re/doc/index.rst
+++ b/boards/st/nucleo_f411re/doc/index.rst
@@ -164,7 +164,7 @@
 Flashing an application to Nucleo F411RE
 ----------------------------------------
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 Run a serial host program to connect with your Nucleo board.
 
@@ -189,7 +189,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/nucleo_f446re/doc/index.rst b/boards/st/nucleo_f446re/doc/index.rst
index 49748ac..e111880 100644
--- a/boards/st/nucleo_f446re/doc/index.rst
+++ b/boards/st/nucleo_f446re/doc/index.rst
@@ -187,7 +187,7 @@
 Flashing an application to Nucleo F446RE
 ----------------------------------------
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 Run a serial host program to connect with your Nucleo board.
 
@@ -212,7 +212,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/nucleo_f446ze/doc/index.rst b/boards/st/nucleo_f446ze/doc/index.rst
index 676da09..0029f01 100644
--- a/boards/st/nucleo_f446ze/doc/index.rst
+++ b/boards/st/nucleo_f446ze/doc/index.rst
@@ -212,7 +212,7 @@
 Flashing an application to Nucleo F446ZE
 ----------------------------------------
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 Run a serial host program to connect with your Nucleo board.
 
@@ -237,7 +237,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/nucleo_f722ze/doc/index.rst b/boards/st/nucleo_f722ze/doc/index.rst
index 37d3237..fde3396 100644
--- a/boards/st/nucleo_f722ze/doc/index.rst
+++ b/boards/st/nucleo_f722ze/doc/index.rst
@@ -201,7 +201,7 @@
    $ west flash --runner openocd
    $ west flash --runner jlink
 
-Build the :ref:`hello_world` application and flash it using the on-board
+Build the :zephyr:code-sample:`hello_world` application and flash it using the on-board
 ST-LINK interface:
 
 .. zephyr-app-commands::
diff --git a/boards/st/nucleo_f746zg/doc/index.rst b/boards/st/nucleo_f746zg/doc/index.rst
index c4d4a0f..59566cf 100644
--- a/boards/st/nucleo_f746zg/doc/index.rst
+++ b/boards/st/nucleo_f746zg/doc/index.rst
@@ -202,7 +202,7 @@
 Flashing an application to Nucleo F746ZG
 ----------------------------------------
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 Run a serial host program to connect with your Nucleo board.
 
@@ -227,7 +227,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/nucleo_f756zg/doc/index.rst b/boards/st/nucleo_f756zg/doc/index.rst
index 3714640..6d512dc 100644
--- a/boards/st/nucleo_f756zg/doc/index.rst
+++ b/boards/st/nucleo_f756zg/doc/index.rst
@@ -183,7 +183,7 @@
 Flashing an application to Nucleo F756ZG
 ----------------------------------------
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 Run a serial host program to connect with your Nucleo board.
 
@@ -208,7 +208,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/nucleo_f767zi/doc/index.rst b/boards/st/nucleo_f767zi/doc/index.rst
index 87c0855..e0b5005 100644
--- a/boards/st/nucleo_f767zi/doc/index.rst
+++ b/boards/st/nucleo_f767zi/doc/index.rst
@@ -203,7 +203,7 @@
 Flashing an application to Nucleo F767ZI
 ----------------------------------------
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 Run a serial host program to connect with your Nucleo board.
 
@@ -228,7 +228,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/nucleo_g031k8/doc/index.rst b/boards/st/nucleo_g031k8/doc/index.rst
index 29ecc49..c377607 100644
--- a/boards/st/nucleo_g031k8/doc/index.rst
+++ b/boards/st/nucleo_g031k8/doc/index.rst
@@ -146,7 +146,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/nucleo_g070rb/doc/index.rst b/boards/st/nucleo_g070rb/doc/index.rst
index 055b11b..87b8cef 100644
--- a/boards/st/nucleo_g070rb/doc/index.rst
+++ b/boards/st/nucleo_g070rb/doc/index.rst
@@ -180,7 +180,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/nucleo_g071rb/doc/index.rst b/boards/st/nucleo_g071rb/doc/index.rst
index 0dc30a9..2202157 100644
--- a/boards/st/nucleo_g071rb/doc/index.rst
+++ b/boards/st/nucleo_g071rb/doc/index.rst
@@ -186,7 +186,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/nucleo_g0b1re/doc/index.rst b/boards/st/nucleo_g0b1re/doc/index.rst
index ba5f860..3a32623 100644
--- a/boards/st/nucleo_g0b1re/doc/index.rst
+++ b/boards/st/nucleo_g0b1re/doc/index.rst
@@ -192,7 +192,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/nucleo_g431rb/doc/index.rst b/boards/st/nucleo_g431rb/doc/index.rst
index 9d87f2f..62805c0 100644
--- a/boards/st/nucleo_g431rb/doc/index.rst
+++ b/boards/st/nucleo_g431rb/doc/index.rst
@@ -222,7 +222,7 @@
    $ minicom -D /dev/ttyACM0
 
 Now build and flash an application. Here is an example for
-:ref:`hello_world`.
+:zephyr:code-sample:`hello_world`.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -240,7 +240,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/nucleo_g474re/doc/index.rst b/boards/st/nucleo_g474re/doc/index.rst
index e4dc198..8ef04ed 100644
--- a/boards/st/nucleo_g474re/doc/index.rst
+++ b/boards/st/nucleo_g474re/doc/index.rst
@@ -229,7 +229,7 @@
    $ minicom -D /dev/ttyACM0
 
 Now build and flash an application. Here is an example for
-:ref:`hello_world`.
+:zephyr:code-sample:`hello_world`.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -247,7 +247,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/nucleo_h503rb/doc/index.rst b/boards/st/nucleo_h503rb/doc/index.rst
index e8ab73b..ed7133c 100644
--- a/boards/st/nucleo_h503rb/doc/index.rst
+++ b/boards/st/nucleo_h503rb/doc/index.rst
@@ -242,7 +242,7 @@
 
 Connect the Nucleo-H503RB to your host computer using the USB port.
 Then build and flash an application. Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 Run a serial host program to connect with your Nucleo board:
 
diff --git a/boards/st/nucleo_h533re/doc/index.rst b/boards/st/nucleo_h533re/doc/index.rst
index eec0ad9..428f79b 100644
--- a/boards/st/nucleo_h533re/doc/index.rst
+++ b/boards/st/nucleo_h533re/doc/index.rst
@@ -293,7 +293,7 @@
 
 Connect the Nucleo H533RE to your host computer using the USB port.
 Then build and flash an application. Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 Run a serial host program to connect with your Nucleo board:
 
diff --git a/boards/st/nucleo_h563zi/doc/index.rst b/boards/st/nucleo_h563zi/doc/index.rst
index f448483..8bbb099 100644
--- a/boards/st/nucleo_h563zi/doc/index.rst
+++ b/boards/st/nucleo_h563zi/doc/index.rst
@@ -307,7 +307,7 @@
 
 Connect the Nucleo H563ZI to your host computer using the USB port.
 Then build and flash an application. Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 Run a serial host program to connect with your Nucleo board:
 
diff --git a/boards/st/nucleo_h723zg/doc/index.rst b/boards/st/nucleo_h723zg/doc/index.rst
index 1e364d8..5e97327 100644
--- a/boards/st/nucleo_h723zg/doc/index.rst
+++ b/boards/st/nucleo_h723zg/doc/index.rst
@@ -197,7 +197,7 @@
 First, connect the NUCLEO-H723ZG to your host computer using
 the USB port to prepare it for flashing. Then build and flash your application.
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 Run a serial host program to connect with your NUCLEO-H723ZG board.
 
@@ -235,7 +235,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/nucleo_h743zi/doc/index.rst b/boards/st/nucleo_h743zi/doc/index.rst
index 403f356..2a79092 100644
--- a/boards/st/nucleo_h743zi/doc/index.rst
+++ b/boards/st/nucleo_h743zi/doc/index.rst
@@ -208,7 +208,7 @@
 Flashing an application to Nucleo H743ZI
 ----------------------------------------
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 Run a serial host program to connect with your Nucleo board.
 
@@ -233,7 +233,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/nucleo_h745zi_q/doc/index.rst b/boards/st/nucleo_h745zi_q/doc/index.rst
index 35e9dd2..c0e5d3d 100644
--- a/boards/st/nucleo_h745zi_q/doc/index.rst
+++ b/boards/st/nucleo_h745zi_q/doc/index.rst
@@ -220,7 +220,7 @@
 First, connect the NUCLEO-H745ZI-Q to your host computer using
 the USB port to prepare it for flashing. Then build and flash your application.
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 Run a serial host program to connect with your NUCLEO-H745ZI-Q board.
 
@@ -270,7 +270,7 @@
 =========
 
 You can debug an application on Cortex M7 side in the usual way. Here is an example
-for the :ref:`hello_world` application.
+for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/nucleo_h753zi/doc/index.rst b/boards/st/nucleo_h753zi/doc/index.rst
index d03b6c1..e9af66a 100644
--- a/boards/st/nucleo_h753zi/doc/index.rst
+++ b/boards/st/nucleo_h753zi/doc/index.rst
@@ -192,7 +192,7 @@
 Flashing an application to Nucleo H753ZI
 ----------------------------------------
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 Run a serial host program to connect with your Nucleo board.
 
@@ -217,7 +217,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/nucleo_h755zi_q/doc/index.rst b/boards/st/nucleo_h755zi_q/doc/index.rst
index d511cb1..3d509cc 100644
--- a/boards/st/nucleo_h755zi_q/doc/index.rst
+++ b/boards/st/nucleo_h755zi_q/doc/index.rst
@@ -209,7 +209,7 @@
 First, connect the NUCLEO-H755ZI-Q to your host computer using
 the USB port to prepare it for flashing. Then build and flash your application.
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 Run a serial host program to connect with your NUCLEO-H755ZI-Q board.
 
@@ -259,7 +259,7 @@
 =========
 
 You can debug an application on the Cortex M7 core in the usual way.
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/nucleo_h7a3zi_q/doc/index.rst b/boards/st/nucleo_h7a3zi_q/doc/index.rst
index 1683e04..0de0ef1 100644
--- a/boards/st/nucleo_h7a3zi_q/doc/index.rst
+++ b/boards/st/nucleo_h7a3zi_q/doc/index.rst
@@ -171,7 +171,7 @@
 Flashing an application to Nucleo H7A3ZI-Q
 ------------------------------------------
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 Run a serial host program to connect with your Nucleo board.
 
@@ -196,7 +196,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/nucleo_l011k4/doc/index.rst b/boards/st/nucleo_l011k4/doc/index.rst
index 7e13a90..b1d9396 100644
--- a/boards/st/nucleo_l011k4/doc/index.rst
+++ b/boards/st/nucleo_l011k4/doc/index.rst
@@ -154,7 +154,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/nucleo_l031k6/doc/index.rst b/boards/st/nucleo_l031k6/doc/index.rst
index 2b1a323..0845a04 100644
--- a/boards/st/nucleo_l031k6/doc/index.rst
+++ b/boards/st/nucleo_l031k6/doc/index.rst
@@ -147,7 +147,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/nucleo_l053r8/doc/index.rst b/boards/st/nucleo_l053r8/doc/index.rst
index 101d4c8..4fd63f5 100644
--- a/boards/st/nucleo_l053r8/doc/index.rst
+++ b/boards/st/nucleo_l053r8/doc/index.rst
@@ -163,7 +163,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/nucleo_l073rz/doc/index.rst b/boards/st/nucleo_l073rz/doc/index.rst
index 70c49d6..6ea4076 100644
--- a/boards/st/nucleo_l073rz/doc/index.rst
+++ b/boards/st/nucleo_l073rz/doc/index.rst
@@ -179,7 +179,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/nucleo_l152re/doc/index.rst b/boards/st/nucleo_l152re/doc/index.rst
index 29a7cab..c4d1819 100644
--- a/boards/st/nucleo_l152re/doc/index.rst
+++ b/boards/st/nucleo_l152re/doc/index.rst
@@ -172,7 +172,7 @@
 =========
 
 You can debug an application in the usual way. Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/nucleo_l412rb_p/doc/index.rst b/boards/st/nucleo_l412rb_p/doc/index.rst
index 97d998d..11a1239 100644
--- a/boards/st/nucleo_l412rb_p/doc/index.rst
+++ b/boards/st/nucleo_l412rb_p/doc/index.rst
@@ -239,7 +239,7 @@
    $ minicom -D /dev/ttyACM0
 
 Now build and flash an application. Here is an example for
-:ref:`hello_world`.
+:zephyr:code-sample:`hello_world`.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -257,7 +257,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/nucleo_l432kc/doc/index.rst b/boards/st/nucleo_l432kc/doc/index.rst
index b54031a..f312380 100644
--- a/boards/st/nucleo_l432kc/doc/index.rst
+++ b/boards/st/nucleo_l432kc/doc/index.rst
@@ -199,7 +199,7 @@
    $ minicom -D /dev/ttyACM0
 
 Now build and flash an application. Here is an example for
-:ref:`hello_world`.
+:zephyr:code-sample:`hello_world`.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -217,7 +217,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/nucleo_l433rc_p/doc/index.rst b/boards/st/nucleo_l433rc_p/doc/index.rst
index 9269652..75b3a8f 100644
--- a/boards/st/nucleo_l433rc_p/doc/index.rst
+++ b/boards/st/nucleo_l433rc_p/doc/index.rst
@@ -204,7 +204,7 @@
    $ picocom /dev/ttyACM0 -b 115200
 
 Now build and flash an application. Here is an example for
-:ref:`hello_world`.
+:zephyr:code-sample:`hello_world`.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -222,7 +222,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/nucleo_l452re/doc/index.rst b/boards/st/nucleo_l452re/doc/index.rst
index 26ff761..9587b9e 100644
--- a/boards/st/nucleo_l452re/doc/index.rst
+++ b/boards/st/nucleo_l452re/doc/index.rst
@@ -223,7 +223,7 @@
    $ minicom -D /dev/ttyACM0
 
 Now build and flash an application. Here is an example for
-:ref:`hello_world`.
+:zephyr:code-sample:`hello_world`.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -248,7 +248,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/nucleo_l476rg/doc/index.rst b/boards/st/nucleo_l476rg/doc/index.rst
index 2e1557e..ac56600 100644
--- a/boards/st/nucleo_l476rg/doc/index.rst
+++ b/boards/st/nucleo_l476rg/doc/index.rst
@@ -206,7 +206,7 @@
 
 Connect the Nucleo L476RG to your host computer using the USB port.
 Then build and flash an application. Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 Run a serial host program to connect with your Nucleo board:
 
@@ -231,7 +231,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/nucleo_l496zg/doc/index.rst b/boards/st/nucleo_l496zg/doc/index.rst
index cc95df2..4abdc10 100644
--- a/boards/st/nucleo_l496zg/doc/index.rst
+++ b/boards/st/nucleo_l496zg/doc/index.rst
@@ -209,7 +209,7 @@
 
 Connect the Nucleo L496ZG to your host computer using the USB port.
 Then build and flash an application. Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 Run a serial host program to connect with your Nucleo board:
 
@@ -234,7 +234,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/nucleo_l4a6zg/doc/index.rst b/boards/st/nucleo_l4a6zg/doc/index.rst
index 428ece2..267d5f6 100644
--- a/boards/st/nucleo_l4a6zg/doc/index.rst
+++ b/boards/st/nucleo_l4a6zg/doc/index.rst
@@ -206,7 +206,7 @@
 
 Connect the Nucleo L4A6ZG to your host computer using the ST-LINK USB port.
 Then build and flash an application. Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 Run a serial host program to connect with your Nucleo board:
 
@@ -231,7 +231,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/nucleo_l4r5zi/doc/index.rst b/boards/st/nucleo_l4r5zi/doc/index.rst
index 7de0870..1a1302a 100644
--- a/boards/st/nucleo_l4r5zi/doc/index.rst
+++ b/boards/st/nucleo_l4r5zi/doc/index.rst
@@ -243,7 +243,7 @@
 Connect the Nucleo L4R5ZI to your host computer using the USB port.
 Then build and flash an application.
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 Run a serial host program to connect with your Nucleo board:
 
diff --git a/boards/st/nucleo_l552ze_q/doc/nucleol552ze_q.rst b/boards/st/nucleo_l552ze_q/doc/nucleol552ze_q.rst
index 79a91fe..0d5aa6e 100644
--- a/boards/st/nucleo_l552ze_q/doc/nucleol552ze_q.rst
+++ b/boards/st/nucleo_l552ze_q/doc/nucleol552ze_q.rst
@@ -315,7 +315,7 @@
 
 Connect the Nucleo L552ZE Q to your host computer using the USB port.
 Then build and flash an application. Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 Run a serial host program to connect with your Nucleo board:
 
@@ -340,7 +340,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/nucleo_u031r8/doc/index.rst b/boards/st/nucleo_u031r8/doc/index.rst
index 869149f..9df168c 100644
--- a/boards/st/nucleo_u031r8/doc/index.rst
+++ b/boards/st/nucleo_u031r8/doc/index.rst
@@ -211,7 +211,7 @@
 
 Connect the Nucleo U031R8 to your host computer using the USB port.
 Then build and flash an application. Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 Run a serial host program to connect with your Nucleo board:
 
diff --git a/boards/st/nucleo_u083rc/doc/index.rst b/boards/st/nucleo_u083rc/doc/index.rst
index 467894a..dd6e3db 100644
--- a/boards/st/nucleo_u083rc/doc/index.rst
+++ b/boards/st/nucleo_u083rc/doc/index.rst
@@ -227,7 +227,7 @@
 
 Connect the Nucleo U083RC to your host computer using the USB port.
 Then build and flash an application. Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 Run a serial host program to connect with your Nucleo board:
 
diff --git a/boards/st/nucleo_u575zi_q/doc/index.rst b/boards/st/nucleo_u575zi_q/doc/index.rst
index 1852246..080bd07 100644
--- a/boards/st/nucleo_u575zi_q/doc/index.rst
+++ b/boards/st/nucleo_u575zi_q/doc/index.rst
@@ -273,7 +273,7 @@
 
 Connect the Nucleo U575ZI Q to your host computer using the USB port.
 Then build and flash an application. Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 Run a serial host program to connect with your Nucleo board:
 
diff --git a/boards/st/nucleo_u5a5zj_q/doc/index.rst b/boards/st/nucleo_u5a5zj_q/doc/index.rst
index 47b36fc..d3f90a1 100644
--- a/boards/st/nucleo_u5a5zj_q/doc/index.rst
+++ b/boards/st/nucleo_u5a5zj_q/doc/index.rst
@@ -305,7 +305,7 @@
 
 Connect the Nucleo U5A5ZJ Q to your host computer using the USB port.
 Then build and flash an application. Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 Run a serial host program to connect with your Nucleo board:
 
diff --git a/boards/st/nucleo_wb05kz/doc/index.rst b/boards/st/nucleo_wb05kz/doc/index.rst
index b743403..7d24254 100644
--- a/boards/st/nucleo_wb05kz/doc/index.rst
+++ b/boards/st/nucleo_wb05kz/doc/index.rst
@@ -110,7 +110,7 @@
    $ minicom -D /dev/ttyACM0
 
 Now build and flash an application. Here is an example for
-:ref:`hello_world`.
+:zephyr:code-sample:`hello_world`.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -128,7 +128,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/nucleo_wb09ke/doc/index.rst b/boards/st/nucleo_wb09ke/doc/index.rst
index af6a5f7..9e4ce9e 100644
--- a/boards/st/nucleo_wb09ke/doc/index.rst
+++ b/boards/st/nucleo_wb09ke/doc/index.rst
@@ -110,7 +110,7 @@
    $ minicom -D /dev/ttyACM0
 
 Now build and flash an application. Here is an example for
-:ref:`hello_world`.
+:zephyr:code-sample:`hello_world`.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -128,7 +128,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/nucleo_wb55rg/doc/nucleo_wb55rg.rst b/boards/st/nucleo_wb55rg/doc/nucleo_wb55rg.rst
index 3a97a2b..fb1b76e 100644
--- a/boards/st/nucleo_wb55rg/doc/nucleo_wb55rg.rst
+++ b/boards/st/nucleo_wb55rg/doc/nucleo_wb55rg.rst
@@ -274,7 +274,7 @@
 
 Connect the Nucleo WB55RG to your host computer using the USB port.
 Then build and flash an application. Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 Run a serial host program to connect with your Nucleo board:
 
diff --git a/boards/st/nucleo_wl55jc/doc/nucleo_wl55jc.rst b/boards/st/nucleo_wl55jc/doc/nucleo_wl55jc.rst
index ca0276e..98ce41d 100644
--- a/boards/st/nucleo_wl55jc/doc/nucleo_wl55jc.rst
+++ b/boards/st/nucleo_wl55jc/doc/nucleo_wl55jc.rst
@@ -282,7 +282,7 @@
 
 Connect the Nucleo WL55JC to your host computer using the USB port.
 Then build and flash an application. Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 Run a serial host program to connect with your Nucleo board:
 
diff --git a/boards/st/st25dv_mb1283_disco/docs/index.rst b/boards/st/st25dv_mb1283_disco/docs/index.rst
index 03acec4..1fef60e 100644
--- a/boards/st/st25dv_mb1283_disco/docs/index.rst
+++ b/boards/st/st25dv_mb1283_disco/docs/index.rst
@@ -101,7 +101,7 @@
 First, connect the ST25DV Discovery kit to your host computer using
 the USB port to prepare it for flashing. Then build and flash your application.
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -124,7 +124,7 @@
 =========
 
 You can debug an application in the usual way. Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/steval_fcu001v1/doc/index.rst b/boards/st/steval_fcu001v1/doc/index.rst
index a76f99c..f10c030 100644
--- a/boards/st/steval_fcu001v1/doc/index.rst
+++ b/boards/st/steval_fcu001v1/doc/index.rst
@@ -123,7 +123,7 @@
 
    $ minicom -D /dev/ttyUSB0
 
-Now build and flash an application. Here is an example for :ref:`hello_world`
+Now build and flash an application. Here is an example for :zephyr:code-sample:`hello_world`
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -140,7 +140,7 @@
 =========
 
 You can debug an application in the usual way. Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/stm3210c_eval/doc/index.rst b/boards/st/stm3210c_eval/doc/index.rst
index 383a0e2..117e378 100644
--- a/boards/st/stm3210c_eval/doc/index.rst
+++ b/boards/st/stm3210c_eval/doc/index.rst
@@ -145,7 +145,7 @@
    $ minicom -D /dev/ttyACM0
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/stm32c0116_dk/doc/index.rst b/boards/st/stm32c0116_dk/doc/index.rst
index 98276b3..52e3c24 100644
--- a/boards/st/stm32c0116_dk/doc/index.rst
+++ b/boards/st/stm32c0116_dk/doc/index.rst
@@ -131,7 +131,7 @@
 First, connect the STM32C0116 Discovery kit to your host computer using
 the USB port to prepare it for flashing. Then build and flash your application.
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/stm32f072b_disco/doc/index.rst b/boards/st/stm32f072b_disco/doc/index.rst
index 6ce491e..6f97341 100644
--- a/boards/st/stm32f072b_disco/doc/index.rst
+++ b/boards/st/stm32f072b_disco/doc/index.rst
@@ -170,7 +170,7 @@
 First, connect the STM32F072B-DISCO Discovery kit to your host computer using
 the USB port to prepare it for flashing. Then build and flash your application.
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -198,7 +198,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/stm32f3_disco/doc/index.rst b/boards/st/stm32f3_disco/doc/index.rst
index 4ad7993..e557eb0 100644
--- a/boards/st/stm32f3_disco/doc/index.rst
+++ b/boards/st/stm32f3_disco/doc/index.rst
@@ -228,7 +228,7 @@
 First, connect the STM32F3DISCOVERY Discovery kit to your host computer using
 the USB port to prepare it for flashing. Then build and flash your application.
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -266,7 +266,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/stm32f412g_disco/doc/index.rst b/boards/st/stm32f412g_disco/doc/index.rst
index 28a5499..ae84de7 100644
--- a/boards/st/stm32f412g_disco/doc/index.rst
+++ b/boards/st/stm32f412g_disco/doc/index.rst
@@ -172,7 +172,7 @@
    $ minicom -D /dev/ttyACM0
 
 Then build and flash an application. Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -190,7 +190,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/stm32f429i_disc1/doc/index.rst b/boards/st/stm32f429i_disc1/doc/index.rst
index c61cfca..28a79e9 100644
--- a/boards/st/stm32f429i_disc1/doc/index.rst
+++ b/boards/st/stm32f429i_disc1/doc/index.rst
@@ -182,7 +182,7 @@
 First, connect the STM32F429I-DISC1 Discovery kit to your host computer using
 the USB port to prepare it for flashing. Then build and flash your application.
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -206,7 +206,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/stm32f469i_disco/doc/index.rst b/boards/st/stm32f469i_disco/doc/index.rst
index 85ebec3..549ffd4 100644
--- a/boards/st/stm32f469i_disco/doc/index.rst
+++ b/boards/st/stm32f469i_disco/doc/index.rst
@@ -162,7 +162,7 @@
 First, connect the STM32F469I-DISCO Discovery kit to your host computer using
 the USB port to prepare it for flashing. Then build and flash your application.
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -186,7 +186,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/stm32f4_disco/doc/index.rst b/boards/st/stm32f4_disco/doc/index.rst
index 128b84f..e590250 100644
--- a/boards/st/stm32f4_disco/doc/index.rst
+++ b/boards/st/stm32f4_disco/doc/index.rst
@@ -199,7 +199,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/stm32f723e_disco/doc/index.rst b/boards/st/stm32f723e_disco/doc/index.rst
index df20151..755e87d 100644
--- a/boards/st/stm32f723e_disco/doc/index.rst
+++ b/boards/st/stm32f723e_disco/doc/index.rst
@@ -158,7 +158,7 @@
 First, connect the STM32F723E Discovery kit to your host computer using
 the USB port to prepare it for flashing. Then build and flash your application.
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -181,7 +181,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/stm32f746g_disco/doc/index.rst b/boards/st/stm32f746g_disco/doc/index.rst
index 7900c49..7bd37aa 100644
--- a/boards/st/stm32f746g_disco/doc/index.rst
+++ b/boards/st/stm32f746g_disco/doc/index.rst
@@ -209,7 +209,7 @@
 First, connect the STM32F746G Discovery kit to your host computer using
 the USB port to prepare it for flashing. Then build and flash your application.
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -232,7 +232,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/stm32f7508_dk/doc/index.rst b/boards/st/stm32f7508_dk/doc/index.rst
index 0ebde3c..7a3c1c9 100644
--- a/boards/st/stm32f7508_dk/doc/index.rst
+++ b/boards/st/stm32f7508_dk/doc/index.rst
@@ -204,7 +204,7 @@
 First, connect the STM32F746G Discovery kit to your host computer using
 the USB port to prepare it for flashing. Then build and flash your application.
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -227,7 +227,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/stm32f769i_disco/doc/index.rst b/boards/st/stm32f769i_disco/doc/index.rst
index 60edc99..210eb84 100644
--- a/boards/st/stm32f769i_disco/doc/index.rst
+++ b/boards/st/stm32f769i_disco/doc/index.rst
@@ -191,7 +191,7 @@
 First, connect the STM32F769I Discovery kit to your host computer using
 the USB port to prepare it for flashing. Then build and flash your application.
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -214,7 +214,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/stm32g0316_disco/doc/index.rst b/boards/st/stm32g0316_disco/doc/index.rst
index 4016137..de6c2d9 100644
--- a/boards/st/stm32g0316_disco/doc/index.rst
+++ b/boards/st/stm32g0316_disco/doc/index.rst
@@ -116,7 +116,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/stm32g071b_disco/doc/index.rst b/boards/st/stm32g071b_disco/doc/index.rst
index 9b1b3c2..e64a06d 100644
--- a/boards/st/stm32g071b_disco/doc/index.rst
+++ b/boards/st/stm32g071b_disco/doc/index.rst
@@ -147,7 +147,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/stm32g081b_eval/doc/index.rst b/boards/st/stm32g081b_eval/doc/index.rst
index 1bae827..1f737c8 100644
--- a/boards/st/stm32g081b_eval/doc/index.rst
+++ b/boards/st/stm32g081b_eval/doc/index.rst
@@ -185,7 +185,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/stm32h573i_dk/doc/index.rst b/boards/st/stm32h573i_dk/doc/index.rst
index 5fad228..86190a7 100644
--- a/boards/st/stm32h573i_dk/doc/index.rst
+++ b/boards/st/stm32h573i_dk/doc/index.rst
@@ -298,7 +298,7 @@
 
 Connect the STM32H573I-DK Discovery to your host computer using the USB port.
 Then build and flash an application. Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 Run a serial host program to connect with your Nucleo board:
 
@@ -331,7 +331,7 @@
    $ pyocd pack --install stm32h5
 
 Once installed, you can debug an application in the usual way. Here is an
-example for the :ref:`hello_world` application.
+example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/stm32h735g_disco/doc/index.rst b/boards/st/stm32h735g_disco/doc/index.rst
index ae14832..3ec250b 100644
--- a/boards/st/stm32h735g_disco/doc/index.rst
+++ b/boards/st/stm32h735g_disco/doc/index.rst
@@ -140,7 +140,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/stm32h745i_disco/doc/index.rst b/boards/st/stm32h745i_disco/doc/index.rst
index 2c5fc70..c5b0ef7 100644
--- a/boards/st/stm32h745i_disco/doc/index.rst
+++ b/boards/st/stm32h745i_disco/doc/index.rst
@@ -195,7 +195,7 @@
 First, connect the STM32H745I-DISCO to your host computer using
 the USB port to prepare it for flashing. Then build and flash your application.
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 Run a serial host program to connect with your STM32H745I-DISCO board.
 
@@ -245,7 +245,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/stm32h747i_disco/doc/index.rst b/boards/st/stm32h747i_disco/doc/index.rst
index 3af5137..4f7a345 100644
--- a/boards/st/stm32h747i_disco/doc/index.rst
+++ b/boards/st/stm32h747i_disco/doc/index.rst
@@ -260,7 +260,7 @@
 First, connect the STM32H747I Discovery kit to your host computer using
 the USB port to prepare it for flashing. Then build and flash your application.
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -297,7 +297,7 @@
 =========
 
 You can debug an application on Cortex M7 side in the usual way.  Here is an example
-for the :ref:`hello_world` application.
+for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/stm32h750b_dk/doc/index.rst b/boards/st/stm32h750b_dk/doc/index.rst
index e450488..3e2cd3d 100644
--- a/boards/st/stm32h750b_dk/doc/index.rst
+++ b/boards/st/stm32h750b_dk/doc/index.rst
@@ -110,7 +110,7 @@
    $ minicom -b 115200 -D /dev/ttyACM0
 
 You can then build and flash applications in the usual way.
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -128,7 +128,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/stm32h7b3i_dk/doc/index.rst b/boards/st/stm32h7b3i_dk/doc/index.rst
index ff6f833..954f434 100644
--- a/boards/st/stm32h7b3i_dk/doc/index.rst
+++ b/boards/st/stm32h7b3i_dk/doc/index.rst
@@ -225,7 +225,7 @@
 First, connect the STM32H7B3I Discovery kit to your host computer using
 the USB port to prepare it for flashing. Then build and flash your application.
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -248,7 +248,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/stm32h7s78_dk/doc/index.rst b/boards/st/stm32h7s78_dk/doc/index.rst
index 62c059c..2352fde 100644
--- a/boards/st/stm32h7s78_dk/doc/index.rst
+++ b/boards/st/stm32h7s78_dk/doc/index.rst
@@ -257,7 +257,7 @@
 
 Connect the STM32H7S78-DK Discovery to your host computer using the USB port.
 Then build and flash an application. Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 Run a serial host program to connect with your Nucleo board:
 
@@ -282,7 +282,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/stm32l476g_disco/doc/index.rst b/boards/st/stm32l476g_disco/doc/index.rst
index 91695ac..94a6e9c 100644
--- a/boards/st/stm32l476g_disco/doc/index.rst
+++ b/boards/st/stm32l476g_disco/doc/index.rst
@@ -190,7 +190,7 @@
    $ minicom -D /dev/ttyACM0
 
 Then, build and flash in the usual way. Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -207,7 +207,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/stm32l496g_disco/doc/index.rst b/boards/st/stm32l496g_disco/doc/index.rst
index 22e575e..15461fb 100644
--- a/boards/st/stm32l496g_disco/doc/index.rst
+++ b/boards/st/stm32l496g_disco/doc/index.rst
@@ -230,7 +230,7 @@
    $ minicom -D /dev/ttyACM0
 
 Then, build and flash in the usual way. Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -247,7 +247,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/stm32l4r9i_disco/doc/index.rst b/boards/st/stm32l4r9i_disco/doc/index.rst
index 5d71a40..6fadc33 100644
--- a/boards/st/stm32l4r9i_disco/doc/index.rst
+++ b/boards/st/stm32l4r9i_disco/doc/index.rst
@@ -122,7 +122,7 @@
    $ minicom -b 115200 -D /dev/ttyACM0
 
 You can then build and flash applications in the usual way.
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -140,7 +140,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
     :zephyr-app: samples/hello_world
diff --git a/boards/st/stm32l562e_dk/doc/index.rst b/boards/st/stm32l562e_dk/doc/index.rst
index 922c03c..55fd91a 100644
--- a/boards/st/stm32l562e_dk/doc/index.rst
+++ b/boards/st/stm32l562e_dk/doc/index.rst
@@ -316,7 +316,7 @@
 
 Connect the STM32L562E-DK Discovery to your host computer using the USB port.
 Then build and flash an application. Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 Run a serial host program to connect with your Nucleo board:
 
@@ -341,7 +341,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/st/stm32u083c_dk/doc/index.rst b/boards/st/stm32u083c_dk/doc/index.rst
index ed6717a..d2f098b 100644
--- a/boards/st/stm32u083c_dk/doc/index.rst
+++ b/boards/st/stm32u083c_dk/doc/index.rst
@@ -240,7 +240,7 @@
 
 Connect the STM32U083C_DK to your host computer using the USB port.
 Then build and flash an application. Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 Run a serial host program to connect with your Nucleo board:
 
diff --git a/boards/st/stm32u5a9j_dk/doc/index.rst b/boards/st/stm32u5a9j_dk/doc/index.rst
index 7e3d638..571ee80 100644
--- a/boards/st/stm32u5a9j_dk/doc/index.rst
+++ b/boards/st/stm32u5a9j_dk/doc/index.rst
@@ -154,7 +154,7 @@
    $ minicom -D /dev/ttyACM0 -b 115200
 
 Then, build and flash in the usual way. Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/tdk/robokit1/doc/index.rst b/boards/tdk/robokit1/doc/index.rst
index ef65431..abc90a0 100644
--- a/boards/tdk/robokit1/doc/index.rst
+++ b/boards/tdk/robokit1/doc/index.rst
@@ -153,7 +153,7 @@
 
 #. Connect the TDK RoboKit1 board to your host computer using the
    USB debug port (USB1), USB2 for a serial console, and remaining micro USB for
-   power. Then build and flash the :ref:`hello_world` application.
+   power. Then build and flash the :zephyr:code-sample:`hello_world` application.
 
    .. zephyr-app-commands::
       :zephyr-app: samples/hello_world
@@ -166,7 +166,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/ti/cc1352p1_launchxl/doc/index.rst b/boards/ti/cc1352p1_launchxl/doc/index.rst
index a5f88cc..b751b35 100644
--- a/boards/ti/cc1352p1_launchxl/doc/index.rst
+++ b/boards/ti/cc1352p1_launchxl/doc/index.rst
@@ -168,7 +168,7 @@
 flashed in the usual way (see :ref:`build_an_application` and
 :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 First, run your favorite terminal program to listen for output.
 
@@ -190,7 +190,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/ti/cc1352p7_launchpad/doc/index.rst b/boards/ti/cc1352p7_launchpad/doc/index.rst
index 8deae6e..2b7fbc1 100644
--- a/boards/ti/cc1352p7_launchpad/doc/index.rst
+++ b/boards/ti/cc1352p7_launchpad/doc/index.rst
@@ -168,7 +168,7 @@
 flashed in the usual way (see :ref:`build_an_application` and
 :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 First, run your favorite terminal program to listen for output.
 
@@ -190,7 +190,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/ti/cc1352r1_launchxl/doc/index.rst b/boards/ti/cc1352r1_launchxl/doc/index.rst
index 0002b1e..2e7ed0a 100644
--- a/boards/ti/cc1352r1_launchxl/doc/index.rst
+++ b/boards/ti/cc1352r1_launchxl/doc/index.rst
@@ -167,7 +167,7 @@
 flashed in the usual way (see :ref:`build_an_application` and
 :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 First, run your favorite terminal program to listen for output.
 
@@ -189,7 +189,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/ti/cc1352r_sensortag/doc/index.rst b/boards/ti/cc1352r_sensortag/doc/index.rst
index c270e85..4120f49 100644
--- a/boards/ti/cc1352r_sensortag/doc/index.rst
+++ b/boards/ti/cc1352r_sensortag/doc/index.rst
@@ -188,7 +188,7 @@
 flashed in the usual way (see :ref:`build_an_application` and
 :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 First, run your favorite terminal program to listen for output.
 
@@ -214,7 +214,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/ti/cc26x2r1_launchxl/doc/index.rst b/boards/ti/cc26x2r1_launchxl/doc/index.rst
index 8177df1..1f6a02d 100644
--- a/boards/ti/cc26x2r1_launchxl/doc/index.rst
+++ b/boards/ti/cc26x2r1_launchxl/doc/index.rst
@@ -173,7 +173,7 @@
 flashed in the usual way (see :ref:`build_an_application` and
 :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 First, run your favorite terminal program to listen for output.
 
@@ -195,7 +195,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/ti/msp_exp432p401r_launchxl/doc/index.rst b/boards/ti/msp_exp432p401r_launchxl/doc/index.rst
index 78662d6..e599424 100644
--- a/boards/ti/msp_exp432p401r_launchxl/doc/index.rst
+++ b/boards/ti/msp_exp432p401r_launchxl/doc/index.rst
@@ -100,7 +100,7 @@
 Follow the :ref:`getting_started` instructions for Zephyr application
 development.
 
-For example, to build and flash the :ref:`hello_world` application for the
+For example, to build and flash the :zephyr:code-sample:`hello_world` application for the
 MSP-EXP432P401R LaunchXL:
 
 .. zephyr-app-commands::
diff --git a/boards/ti/sk_am62/doc/index.rst b/boards/ti/sk_am62/doc/index.rst
index 98f03bf..60252c2 100644
--- a/boards/ti/sk_am62/doc/index.rst
+++ b/boards/ti/sk_am62/doc/index.rst
@@ -94,7 +94,7 @@
 
 The testing requires the binary to be copied to the SD card to allow the A53 cores to load it while booting using remoteproc.
 
-To test the M4F core, we build the :ref:`hello_world` sample with the following command.
+To test the M4F core, we build the :zephyr:code-sample:`hello_world` sample with the following command.
 
 .. code-block:: console
 
diff --git a/boards/toradex/verdin_imx8mp/doc/index.rst b/boards/toradex/verdin_imx8mp/doc/index.rst
index de7751f..e59101f 100644
--- a/boards/toradex/verdin_imx8mp/doc/index.rst
+++ b/boards/toradex/verdin_imx8mp/doc/index.rst
@@ -251,7 +251,7 @@
 X56 debug connector and to the PC, or simply connecting a USB-C to X66 on the Verdin Development
 Board. Then, the application can be debugged using the usual way.
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/u-blox/ubx_bmd300eval/doc/index.rst b/boards/u-blox/ubx_bmd300eval/doc/index.rst
index d1aea13..d7043ad 100644
--- a/boards/u-blox/ubx_bmd300eval/doc/index.rst
+++ b/boards/u-blox/ubx_bmd300eval/doc/index.rst
@@ -348,7 +348,7 @@
 applications as usual (see :ref:`build_an_application` and
 :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 First, run your favorite terminal program to listen for output.
 
diff --git a/boards/u-blox/ubx_bmd330eval/doc/index.rst b/boards/u-blox/ubx_bmd330eval/doc/index.rst
index 3f065cf..63c1755 100644
--- a/boards/u-blox/ubx_bmd330eval/doc/index.rst
+++ b/boards/u-blox/ubx_bmd330eval/doc/index.rst
@@ -339,7 +339,7 @@
 applications as usual (see :ref:`build_an_application` and
 :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 First, run your favorite terminal program to listen for output.
 
diff --git a/boards/u-blox/ubx_bmd340eval/doc/index.rst b/boards/u-blox/ubx_bmd340eval/doc/index.rst
index 4e1fed4..8129bf3 100644
--- a/boards/u-blox/ubx_bmd340eval/doc/index.rst
+++ b/boards/u-blox/ubx_bmd340eval/doc/index.rst
@@ -408,7 +408,7 @@
 applications as usual (see :ref:`build_an_application` and
 :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 First, run your favorite terminal program to listen for output.
 
diff --git a/boards/u-blox/ubx_bmd345eval/doc/index.rst b/boards/u-blox/ubx_bmd345eval/doc/index.rst
index 0bcb1d2..907370f 100644
--- a/boards/u-blox/ubx_bmd345eval/doc/index.rst
+++ b/boards/u-blox/ubx_bmd345eval/doc/index.rst
@@ -421,7 +421,7 @@
 applications as usual (see :ref:`build_an_application` and
 :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 First, run your favorite terminal program to listen for output.
 
diff --git a/boards/u-blox/ubx_bmd360eval/doc/index.rst b/boards/u-blox/ubx_bmd360eval/doc/index.rst
index 556620a..f0fbf26 100644
--- a/boards/u-blox/ubx_bmd360eval/doc/index.rst
+++ b/boards/u-blox/ubx_bmd360eval/doc/index.rst
@@ -337,7 +337,7 @@
 applications as usual (see :ref:`build_an_application` and
 :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 First, run your favorite terminal program to listen for output.
 
diff --git a/boards/u-blox/ubx_bmd380eval/doc/index.rst b/boards/u-blox/ubx_bmd380eval/doc/index.rst
index 1547cfc..e903b1e 100644
--- a/boards/u-blox/ubx_bmd380eval/doc/index.rst
+++ b/boards/u-blox/ubx_bmd380eval/doc/index.rst
@@ -407,7 +407,7 @@
 applications as usual (see :ref:`build_an_application` and
 :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 First, run your favorite terminal program to listen for output.
 
diff --git a/boards/u-blox/ubx_evkannab1/doc/index.rst b/boards/u-blox/ubx_evkannab1/doc/index.rst
index f464ab5..79606e2 100644
--- a/boards/u-blox/ubx_evkannab1/doc/index.rst
+++ b/boards/u-blox/ubx_evkannab1/doc/index.rst
@@ -116,7 +116,7 @@
 Build and flash applications as usual (see
 :ref:`build_an_application` and :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 Open a terminal program to the USB Serial Port installed when connecting
 the board and listen for output.
diff --git a/boards/u-blox/ubx_evkninab1/doc/index.rst b/boards/u-blox/ubx_evkninab1/doc/index.rst
index 9073c22..33dcecb 100644
--- a/boards/u-blox/ubx_evkninab1/doc/index.rst
+++ b/boards/u-blox/ubx_evkninab1/doc/index.rst
@@ -124,7 +124,7 @@
 Build and flash applications as usual (see
 :ref:`build_an_application` and :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 Open a terminal program to the USB Serial Port installed when connecting
 the board and listen for output.
diff --git a/boards/u-blox/ubx_evkninab3/doc/index.rst b/boards/u-blox/ubx_evkninab3/doc/index.rst
index fb8b015..d19f49c 100644
--- a/boards/u-blox/ubx_evkninab3/doc/index.rst
+++ b/boards/u-blox/ubx_evkninab3/doc/index.rst
@@ -223,7 +223,7 @@
 applications as usual (see :ref:`build_an_application` and
 :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 First, run your favorite terminal program to listen for output.
 
diff --git a/boards/u-blox/ubx_evkninab4/doc/index.rst b/boards/u-blox/ubx_evkninab4/doc/index.rst
index 5ad6289..ebb3ee0 100644
--- a/boards/u-blox/ubx_evkninab4/doc/index.rst
+++ b/boards/u-blox/ubx_evkninab4/doc/index.rst
@@ -119,7 +119,7 @@
 Build and flash applications as usual (see
 :ref:`build_an_application` and :ref:`application_run` for more details)
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 Open a terminal program to the USB Serial Port installed when connecting
 the board and listen for output.
diff --git a/boards/vcc-gnd/yd_esp32/doc/index.rst b/boards/vcc-gnd/yd_esp32/doc/index.rst
index d847f45..20201b3 100644
--- a/boards/vcc-gnd/yd_esp32/doc/index.rst
+++ b/boards/vcc-gnd/yd_esp32/doc/index.rst
@@ -213,7 +213,7 @@
    :goals: build
 
 The usual ``flash`` target will work with the ``yd_esp32`` board
-configuration. Here is an example for the :ref:`hello_world`
+configuration. Here is an example for the :zephyr:code-sample:`hello_world`
 application.
 
 .. zephyr-app-commands::
@@ -278,14 +278,14 @@
 
 Further documentation can be obtained from the SoC vendor in `JTAG debugging for ESP32`_.
 
-Here is an example for building the :ref:`hello_world` application.
+Here is an example for building the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
    :board: yd_esp32/esp32/procpu
    :goals: build flash
 
-You can debug an application in the usual way. Here is an example for the :ref:`hello_world` application.
+You can debug an application in the usual way. Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/vcc-gnd/yd_stm32h750vb/doc/index.rst b/boards/vcc-gnd/yd_stm32h750vb/doc/index.rst
index 5a5775c..2b5e179 100644
--- a/boards/vcc-gnd/yd_stm32h750vb/doc/index.rst
+++ b/boards/vcc-gnd/yd_stm32h750vb/doc/index.rst
@@ -105,7 +105,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/vngiotlab/nrf51_vbluno51/doc/index.rst b/boards/vngiotlab/nrf51_vbluno51/doc/index.rst
index 92d74c0..b56bcdd 100644
--- a/boards/vngiotlab/nrf51_vbluno51/doc/index.rst
+++ b/boards/vngiotlab/nrf51_vbluno51/doc/index.rst
@@ -135,7 +135,7 @@
  Here are some sample applications that you can use to test different
  components on the VBLUno51 board:
 
- * :ref:`hello_world`
+ * :zephyr:code-sample:`hello_world`
  * :zephyr:code-sample:`blinky`
  * :zephyr:code-sample:`button`
  * :zephyr:code-sample:`bluetooth_beacon`
diff --git a/boards/vngiotlab/nrf52_vbluno52/doc/index.rst b/boards/vngiotlab/nrf52_vbluno52/doc/index.rst
index f534ae3..68a7c1b 100644
--- a/boards/vngiotlab/nrf52_vbluno52/doc/index.rst
+++ b/boards/vngiotlab/nrf52_vbluno52/doc/index.rst
@@ -87,7 +87,7 @@
 your development environment.
 
 You can build and flash applications in the usual way. Here is an
-example for the :ref:`hello_world` application.
+example for the :zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -100,7 +100,7 @@
 Here are some sample applications that you can use to test different
 components on the VBLUno52 board:
 
-* :ref:`hello_world`
+* :zephyr:code-sample:`hello_world`
 * :zephyr:code-sample:`blinky`
 * :zephyr:code-sample:`button`
 * :zephyr:code-sample:`bluetooth_beacon`
diff --git a/boards/waveshare/nrf51_ble400/doc/index.rst b/boards/waveshare/nrf51_ble400/doc/index.rst
index 3bfe06a..3d34f2f 100644
--- a/boards/waveshare/nrf51_ble400/doc/index.rst
+++ b/boards/waveshare/nrf51_ble400/doc/index.rst
@@ -168,7 +168,7 @@
 applications as usual (see :ref:`build_an_application` and
 :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 First, run your favorite terminal program to listen for output.
 
diff --git a/boards/waveshare/open103z/doc/index.rst b/boards/waveshare/open103z/doc/index.rst
index 2cd9c7a..773b60f 100644
--- a/boards/waveshare/open103z/doc/index.rst
+++ b/boards/waveshare/open103z/doc/index.rst
@@ -55,7 +55,7 @@
 ========
 
 Build and flash applications as usual. Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
@@ -66,7 +66,7 @@
 =========
 
 Debug applications as usual. Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/boards/we/ophelia1ev/doc/index.rst b/boards/we/ophelia1ev/doc/index.rst
index d64c325..908b0ce 100644
--- a/boards/we/ophelia1ev/doc/index.rst
+++ b/boards/we/ophelia1ev/doc/index.rst
@@ -82,7 +82,7 @@
 applications as usual (see :ref:`build_an_application` and
 :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 First, run your favorite terminal program to listen for output.
 
diff --git a/boards/we/proteus2ev/doc/index.rst b/boards/we/proteus2ev/doc/index.rst
index 5492b41..19a7df8 100644
--- a/boards/we/proteus2ev/doc/index.rst
+++ b/boards/we/proteus2ev/doc/index.rst
@@ -112,7 +112,7 @@
 applications as usual (see :ref:`build_an_application` and
 :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 First, run your favorite terminal program to listen for output.
 
diff --git a/boards/we/proteus3ev/doc/index.rst b/boards/we/proteus3ev/doc/index.rst
index dd6c5f4..87180a8 100644
--- a/boards/we/proteus3ev/doc/index.rst
+++ b/boards/we/proteus3ev/doc/index.rst
@@ -114,7 +114,7 @@
 applications as usual (see :ref:`build_an_application` and
 :ref:`application_run` for more details).
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 First, run your favorite terminal program to listen for output.
 
diff --git a/boards/weact/mini_stm32h743/doc/index.rst b/boards/weact/mini_stm32h743/doc/index.rst
index 4a96538..9b63292 100644
--- a/boards/weact/mini_stm32h743/doc/index.rst
+++ b/boards/weact/mini_stm32h743/doc/index.rst
@@ -168,7 +168,7 @@
 Flashing an application to MiniSTM32H743
 ----------------------------------------
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 First, put the board in bootloader mode as described above. Then build and flash
 the application in the usual way. Just add ``CONFIG_BOOT_DELAY=5000`` to the
diff --git a/boards/wemos/esp32s2_lolin_mini/doc/index.rst b/boards/wemos/esp32s2_lolin_mini/doc/index.rst
index 7068265..d09dec2 100644
--- a/boards/wemos/esp32s2_lolin_mini/doc/index.rst
+++ b/boards/wemos/esp32s2_lolin_mini/doc/index.rst
@@ -66,7 +66,7 @@
 configuration after putting the board into bootloader mode by holding the '0'
 button then pressing 'RST' and releasing the 'RST' button.
 
-Here is an example for the :ref:`hello_world`
+Here is an example for the :zephyr:code-sample:`hello_world`
 application.
 
 .. zephyr-app-commands::
diff --git a/boards/witte/linum/doc/index.rst b/boards/witte/linum/doc/index.rst
index 86fbbea..a7998af 100644
--- a/boards/witte/linum/doc/index.rst
+++ b/boards/witte/linum/doc/index.rst
@@ -369,7 +369,7 @@
 Flashing an application to the Linum board
 -------------------------------------------
 
-Here is an example for the :ref:`hello_world` application.
+Here is an example for the :zephyr:code-sample:`hello_world` application.
 
 Run a serial host program to connect with your Nucleo board.
 
@@ -394,7 +394,7 @@
 =========
 
 You can debug an application in the usual way.  Here is an example for the
-:ref:`hello_world` application.
+:zephyr:code-sample:`hello_world` application.
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/doc/build/dts/howtos.rst b/doc/build/dts/howtos.rst
index 8875e9c..5bd4df9 100644
--- a/doc/build/dts/howtos.rst
+++ b/doc/build/dts/howtos.rst
@@ -23,10 +23,10 @@
 
 .. tip::
 
-   You can build :ref:`hello_world` to see the "base" devicetree for your board
+   You can build :zephyr:code-sample:`hello_world` to see the "base" devicetree for your board
    without any additional changes from :ref:`overlay files <dt-input-files>`.
 
-For example, using the :ref:`qemu_cortex_m3` board to build :ref:`hello_world`:
+For example, using the :ref:`qemu_cortex_m3` board to build :zephyr:code-sample:`hello_world`:
 
 .. code-block:: sh
 
diff --git a/doc/build/dts/troubleshooting.rst b/doc/build/dts/troubleshooting.rst
index 71521a3..3cb360d 100644
--- a/doc/build/dts/troubleshooting.rst
+++ b/doc/build/dts/troubleshooting.rst
@@ -261,7 +261,7 @@
 
 To save preprocessor output files, enable the
 :kconfig:option:`CONFIG_COMPILER_SAVE_TEMPS` option. For example, to build
-:ref:`hello_world` with west with this option set, use:
+:zephyr:code-sample:`hello_world` with west with this option set, use:
 
 .. code-block:: sh
 
@@ -300,7 +300,7 @@
 :kconfig:option:`CONFIG_COMPILER_TRACK_MACRO_EXPANSION` option. This typically
 reduces the output to one message per error.
 
-For example, to build :ref:`hello_world` with west and this option disabled,
+For example, to build :zephyr:code-sample:`hello_world` with west and this option disabled,
 use:
 
 .. code-block:: sh
diff --git a/doc/build/sysbuild/index.rst b/doc/build/sysbuild/index.rst
index dae7c6a..80c11ce 100644
--- a/doc/build/sysbuild/index.rst
+++ b/doc/build/sysbuild/index.rst
@@ -157,7 +157,7 @@
 namespaces to direct settings either to sysbuild itself or to a specific Zephyr
 application managed by sysbuild using the information in these sections.
 
-The following example shows how to build :ref:`hello_world` with MCUboot enabled,
+The following example shows how to build :zephyr:code-sample:`hello_world` with MCUboot enabled,
 applying to both images debug optimizations:
 
 .. tabs::
diff --git a/doc/develop/application/index.rst b/doc/develop/application/index.rst
index fff35bb..64d99dc 100644
--- a/doc/develop/application/index.rst
+++ b/doc/develop/application/index.rst
@@ -131,7 +131,7 @@
 
 An application located within the ``zephyr`` source code repository in a Zephyr
 :ref:`west workspace <west-workspaces>` is referred to as a Zephyr repository
-application. In the following example, the :ref:`hello_world sample
+application. In the following example, the :zephyr:code-sample:`hello_world sample
 <hello_world>` is a Zephyr repository application:
 
 .. code-block:: none
diff --git a/doc/develop/beyond-GSG.rst b/doc/develop/beyond-GSG.rst
index cc5e770..42f1f6c 100644
--- a/doc/develop/beyond-GSG.rst
+++ b/doc/develop/beyond-GSG.rst
@@ -286,7 +286,7 @@
 :ref:`set the environment variable <env_vars>`
 ``QEMU_BIN_PATH`` to the path of QEMU installation folder.
 
-For example, you can build and run the :ref:`hello_world` sample using
+For example, you can build and run the :zephyr:code-sample:`hello_world` sample using
 the x86 emulation board configuration (``qemu_x86``), with:
 
 .. zephyr-app-commands::
diff --git a/doc/develop/getting_started/index.rst b/doc/develop/getting_started/index.rst
index 0332c98..34f21e4 100644
--- a/doc/develop/getting_started/index.rst
+++ b/doc/develop/getting_started/index.rst
@@ -402,7 +402,7 @@
 
    :zephyr:code-sample:`blinky` is compatible with most, but not all, :ref:`boards`. If your board
    does not meet Blinky's :ref:`blinky-sample-requirements`, then
-   :ref:`hello_world` is a good alternative.
+   :zephyr:code-sample:`hello_world` is a good alternative.
 
    If you are unsure what name west uses for your board, ``west boards``
    can be used to obtain a list of all boards Zephyr supports.
diff --git a/doc/develop/west/build-flash-debug.rst b/doc/develop/west/build-flash-debug.rst
index a7c1985..36a4d5d 100644
--- a/doc/develop/west/build-flash-debug.rst
+++ b/doc/develop/west/build-flash-debug.rst
@@ -145,7 +145,7 @@
 To specify the build system target to run, use ``--target`` (or ``-t``).
 
 For example, on host platforms with QEMU, you can use the ``run`` target to
-build and run the :ref:`hello_world` sample for the emulated :ref:`qemu_x86
+build and run the :zephyr:code-sample:`hello_world` sample for the emulated :ref:`qemu_x86
 <qemu_x86>` board in one command::
 
   west build -b qemu_x86 -t run samples/hello_world
@@ -349,7 +349,7 @@
 Build a single domain
 ---------------------
 
-In a multi-domain build with :ref:`hello_world` and `MCUboot`_, you can use
+In a multi-domain build with :zephyr:code-sample:`hello_world` and `MCUboot`_, you can use
 ``--domain hello_world`` to only build this domain::
 
   west build --sysbuild --domain hello_world
@@ -543,7 +543,7 @@
 It is possible to flash the image from a single domain in a multi-domain project
 by using ``--domain``.
 
-For example, in a multi-domain build with :ref:`hello_world` and
+For example, in a multi-domain build with :zephyr:code-sample:`hello_world` and
 `MCUboot`_, you can use the ``--domain hello_world`` domain to only flash
 only the image from this domain::
 
diff --git a/doc/develop/west/sign.rst b/doc/develop/west/sign.rst
index 355682c..7de7bf7 100644
--- a/doc/develop/west/sign.rst
+++ b/doc/develop/west/sign.rst
@@ -22,7 +22,7 @@
 build system will do it for you.
 
 Here is an example workflow, which builds and flashes MCUboot, as well as the
-:ref:`hello_world` application for chain-loading by MCUboot. Run these commands
+:zephyr:code-sample:`hello_world` application for chain-loading by MCUboot. Run these commands
 from the :file:`zephyrproject` workspace you created in the
 :ref:`getting_started`.
 
diff --git a/doc/hardware/peripherals/can/shell.rst b/doc/hardware/peripherals/can/shell.rst
index 0457203..9c0999b 100644
--- a/doc/hardware/peripherals/can/shell.rst
+++ b/doc/hardware/peripherals/can/shell.rst
@@ -35,7 +35,7 @@
   well.
 * :kconfig:option:`CONFIG_CAN_MANUAL_RECOVERY_MODE` enables the ``can recover`` subcommand.
 
-For example, building the :ref:`hello_world` sample for the :ref:`frdm_k64f` with the CAN shell and
+For example, building the :zephyr:code-sample:`hello_world` sample for the :ref:`frdm_k64f` with the CAN shell and
 CAN statistics enabled:
 
 .. zephyr-app-commands::
diff --git a/doc/hardware/peripherals/eeprom/shell.rst b/doc/hardware/peripherals/eeprom/shell.rst
index b1b1535..2b4d182 100644
--- a/doc/hardware/peripherals/eeprom/shell.rst
+++ b/doc/hardware/peripherals/eeprom/shell.rst
@@ -21,7 +21,7 @@
 * :kconfig:option:`CONFIG_EEPROM`
 * :kconfig:option:`CONFIG_EEPROM_SHELL`
 
-For example, building the :ref:`hello_world` sample for the :ref:`native_sim` with the EEPROM shell:
+For example, building the :zephyr:code-sample:`hello_world` sample for the :ref:`native_sim` with the EEPROM shell:
 
 .. zephyr-app-commands::
    :zephyr-app: samples/hello_world
diff --git a/samples/hello_world/README.rst b/samples/hello_world/README.rst
index ce5423d..25b346e 100644
--- a/samples/hello_world/README.rst
+++ b/samples/hello_world/README.rst
@@ -1,4 +1,7 @@
-.. _hello_world:
+.. zephyr:code-sample:: hello_world
+   :name: Hello World
+
+   Print "Hello World" to the console.
 
 Hello World
 ###########
diff --git a/samples/subsys/usb/dfu/README.rst b/samples/subsys/usb/dfu/README.rst
index 9fe9fd0..44b1731 100644
--- a/samples/subsys/usb/dfu/README.rst
+++ b/samples/subsys/usb/dfu/README.rst
@@ -46,7 +46,7 @@
 the `Using MCUboot with Zephyr`_ documentation. Then build, sign and flash
 the USB DFU sample at the offset of SLOT-0.
 
-Build and sign a second application image e.g. :ref:`hello_world`,
+Build and sign a second application image e.g. :zephyr:code-sample:`hello_world`,
 which will be used as an image for the update.
 Do not forget to enable the required :kconfig:option:`CONFIG_BOOTLOADER_MCUBOOT` option (as described
 in :ref:`mcuboot`). For example: