doc: nrf91: snippet page edits

Edited the snippet page under Developing with nRF91
for style and consistency.
NRFU-1011.

Signed-off-by: Grzegorz Ferenc <[email protected]>

Author: greg-fer

doc/nrf/device_guides/nrf91/nrf91_programming.rst

@@ -21,6 +21,8 @@ Compatible versions of modem and application
 
 When you update the application firmware on an nRF91 Series DK, make sure that the modem firmware and application firmware are compatible versions.
 
+.. _build_pgm_nrf9160_board_controller:
+
 Selecting board controller on nRF9160 DK
 ****************************************
 

doc/nrf/device_guides/nrf91/nrf91_snippet.rst

@@ -7,30 +7,34 @@ Snippets for an nRF91 Series device
    :local:
    :depth: 2
 
-
 nRF91 Series' :ref:`app_build_snippets` are tailored for tracing on the nRF91 Series devices but can work with other boards as well.
-On nRF91 Series devices, snippets are used for the following functionalities:
-
-* Modem tracing with the flash backend
-* Modem tracing with the UART backend
-* To activate TF-M logging while having modem traces enabled
+On nRF91 Series devices, you can enable the following functionalities using snippets:
+
+.. list-table::
+   :header-rows: 1
+
+   * - Functionality
+     - Snippet name
+     - Compatible board targets
+   * - :ref:`nrf91_modem_trace_ext_flash_snippet`
+     - ``nrf91-modem-trace-ext-flash``
+     - ``nrf9151dk/nrf9151/ns``, ``nrf9161dk/nrf9161/ns``, ``nrf9160dk/nrf9160/ns``, ``nrf9131ek/nrf9131/ns``
+   * - :ref:`nrf91_modem_trace_uart_snippet`
+     - ``nrf91-modem-trace-uart``
+     - :ref:`All nRF91 Series board targets <ug_nrf91>`
+   * - :ref:`tfm_enable_share_uart`
+     - ``tfm-enable-share-uart``
+     - :ref:`All nRF91 Series board targets <ug_nrf91>`
 
 .. _nrf91_modem_trace_ext_flash_snippet:
 
 nRF91 modem traces with flash backend using snippets
 ****************************************************
 
-Snippet enables modem tracing, the flash backend, and external flash and configures them to store modem traces to a dedicated partition on the external flash for supported boards.
+The ``nrf91-modem-trace-ext-flash`` snippet enables modem tracing, the flash backend, and external flash and configures them to store modem traces to a dedicated partition on the external flash for supported boards.
 To change the partition size, the project needs to configure the :kconfig:option:`CONFIG_NRF_MODEM_LIB_TRACE_BACKEND_FLASH_PARTITION_SIZE` Kconfig option.
 
-The following board targets have support for this snippet:
-
-* ``nrf9151dk/nrf9151/ns``
-* ``nrf9161dk/nrf9161/ns``
-* ``nrf9160dk/nrf9160/ns``
-* ``nrf9131ek/nrf9131/ns``
-
-To enable modem traces with the flash backend, use the following command, where *board_target* corresponds to your development kit board target and `<image_name>` to your application image name:
+To enable modem traces with the flash backend, use the following command pattern, where *board_target* corresponds to your board target and `<image_name>` to your application image name:
 
 .. parsed-literal::
    :class: highlight
@@ -42,46 +46,50 @@ To enable modem traces with the flash backend, use the following command, where
 nRF91 modem tracing with UART backend using snippets
 ****************************************************
 
-Snippet enables the :kconfig:option:`CONFIG_NRF_MODEM_LIB_TRACE` Kconfig option and chooses the Zephyr UART driver for the backend, with the necessary Kconfig options.
+The ``nrf91-modem-trace-uart`` snippet enables the :kconfig:option:`CONFIG_NRF_MODEM_LIB_TRACE` Kconfig option and chooses the Zephyr UART driver for the backend, with the necessary Kconfig options.
 The snippet also enables the UART1 peripheral with a baud rate of 1 Mbd and hardware flow control enabled.
 If this configuration does not match your requirements, you can add a snippet or Kconfig and devicetree overlays to your application with the desired setup.
+
+.. note::
+    If you are using the nRF9160 DK, remember to :ref:`set the board controller switch to the **nRF91** position <build_pgm_nrf9160_board_controller>` before programming.
+
 To enable modem tracing with the UART trace backend on a nRF91 device, add the ``nrf91-modem-trace-uart`` snippet to the :term:`build configuration`.
 This can be done in one of the following ways:
 
-With west
-=========
+.. tabs::
 
-To add the modem trace UART snippet when building an application with west, use the following command, where *board_target* corresponds to your development kit board target and `<image_name>` to your application image name:
+   .. group-tab:: west
 
-.. parsed-literal::
-   :class: highlight
+      To add the modem trace UART snippet when building an application with west, use the following command pattern, where *board_target* corresponds to your board target and `<image_name>` to your application image name:
 
-   west build --board *board_target* -- -D<image_name>_SNIPPET="nrf91-modem-trace-uart"
+      .. parsed-literal::
+        :class: highlight
 
-.. note::
-   With :ref:`sysbuild <configuration_system_overview_sysbuild>`, using the ``west build -S`` option applies the snippet to all images.
-   Therefore, use the CMake argument instead, specifying the application image.
+        west build --board *board_target* -- -D<image_name>_SNIPPET="nrf91-modem-trace-uart"
+
+      .. note::
+          With :ref:`sysbuild <configuration_system_overview_sysbuild>`, using the ``west build -S`` option applies the snippet to all images.
+          Therefore, use the CMake argument instead, specifying the application image.
 
-With CMake
-==========
+   .. group-tab:: CMake
 
-To add the modem trace UART snippet when building an application with CMake, add the following command to the CMake arguments:
+      To add the modem trace UART snippet when building an application with CMake, add the following command to the CMake arguments:
 
-.. code-block:: console
+      .. code-block:: console
 
-   -D<image_name>_SNIPPET="nrf91-modem-trace-uart" [...]
+        -D<image_name>_SNIPPET="nrf91-modem-trace-uart" [...]
 
-To build with the |nRFVSC|, specify ``-D<image_name>_SNIPPET="nrf91-modem-trace-uart" [...]`` in the **Extra CMake arguments** field.
+      To build with the |nRFVSC|, specify ``-D<image_name>_SNIPPET="nrf91-modem-trace-uart" [...]`` in the **Extra CMake arguments** field.
 
-See :ref:`cmake_options` for more details.
+      See :ref:`cmake_options` for more details.
 
 .. _tfm_enable_share_uart:
 
 Shared UART for application and TF-M logging
 ********************************************
 
 If you want to activate TF-M logging while having modem traces enabled, it can be useful to direct the TF-M logs to the UART (**UART0**) used by the application.
-To activate both modem traces and TF-M logs, use the following command:
+To activate both modem traces and TF-M logs, use the following command pattern, where *board_target* corresponds to your board target:
 
 .. parsed-literal::
    :class: highlight