doc: a few doc edits

please squash

Signed-off-by: Bartosz Gentkowski <[email protected]>

Author: b-gent

doc/nrf-bm/drivers.rst

@@ -10,8 +10,8 @@ Only nrfx drivers and the drivers located under :file:`nrf-bm/drivers` are in th
 All other drivers that are included in the distribution must be ignored when working with the |BMshort| option.
 
 .. toctree::
-   :maxdepth: 2
+   :maxdepth: 1
    :glob:
    :caption: Subpages:
 
-   drivers/lpuarte.rst
+   drivers/*

doc/nrf-bm/drivers/lpuarte.rst

@@ -1,4 +1,4 @@
-.. _lpuarte:
+.. _driver_lpuarte:
 
 Low Power UART with EasyDMA (LPUARTE)
 #####################################
@@ -22,6 +22,9 @@ It is configured as an output and set to low.
 
 The RDY line is configured as input without pull-up and the interrupt is configured to detect the transition from low to high state.
 
+Implementation
+**************
+
 The driver implements the control protocol in the following way:
 
 #. The transmitter initiates the transmission by calling :c:func:`bm_lpuarte_tx`.
@@ -46,4 +49,7 @@ This requirement can be fulfilled in two ways:
   The latency of the event handling must be taken into account in that case.
   For example, a flash page erase on some devices might have a significant impact.
 
-See :ref:`bm_lpuarte_sample` sample for the implementation of this driver.
+Sample usage
+************
+
+See the :ref:`bm_lpuarte_sample` sample for the implementation of this driver.

doc/nrf-bm/index.rst

@@ -35,6 +35,7 @@ The |BMlong| is a distinct repository that incorporates elements from the existi
    :caption: Contents
 
    install_nrf_bm.rst
+   drivers.rst
    libraries/index.rst
    samples.rst
    ug_dfu.rst

samples/bluetooth/ble_nus/README.rst

@@ -63,13 +63,13 @@ This sample can be found under :file:`samples/bluetooth/ble_nus/` in the |BMshor
 Building and running with LPUARTE
 *********************************
 
-The :file:`overlay-lpuarte.conf` file configures the sample to use the :ref:`lpuarte` driver for the NUS Service.
-This is useful to reduce power consumption.
+The :file:`overlay-lpuarte.conf` file configures the sample to use the :ref:`LPUARTE <driver_lpuarte>` driver for the NUS Service.
+This is useful for reducing the power consumption.
 The overlay must be added to the build configuration is VS Code or as an extra argument to west: ``-DEXTRA_CONF_FILE="overlay-lpuarte.conf"``.
 
-To test the NUS sample with the :ref:`lpuarte` driver in loopback mode, connect pin ``P1.08`` (REQ) with ``P1.09`` (RDY) and ``P1.10`` (RX) with ``P1.11`` (TX) on the nRF54L15DK as given in the ``board-config.h``.
+To test the NUS sample with the :ref:`LPUARTE <driver_lpuarte>` driver in loopback mode, connect pin ``P1.08`` (REQ) with ``P1.09`` (RDY) and ``P1.10`` (RX) with ``P1.11`` (TX) on the nRF54L15DK, as given in the :file:`board-config.h`.
 It is also possible to test between two devices running NUS with LPUART by connecting the above mentioned pins and ``GND`` between the devices.
-Make sure the ``REQ`` pin on one bord is connected to the ``RDY`` on the other board, and vice versa.
+Make sure the ``REQ`` pin on one board is connected to the ``RDY`` on the other board, and vice versa.
 
 Testing
 =======