diff --git a/Documentation/platforms/arm/mx8mp/boards/verdin-mx8mp/README.txt b/Documentation/platforms/arm/mx8mp/boards/verdin-mx8mp/README.txt
deleted file mode 100644
index 50d4305bb40..00000000000
--- a/Documentation/platforms/arm/mx8mp/boards/verdin-mx8mp/README.txt
+++ /dev/null
@@ -1,19 +0,0 @@
-README for the verdin-mx8mp Relax
-============================
-
-  The directory provides board support for the Toradex Verdin mx8mp.
-  Note: this port works on the internal Cortex-M7 auxiliary core, NOT the main Cortex-53 complex!
-
-  LEDs and buttons shall be connected to header pins like this:
-  - LED21 on GPIO_4
-  - LED22 on GPIO_3
-  - LED23 on GPIO_2
-  - LED24 on GPIO_1
-  - SW11 on GPIO_5_CSI
-  You can adjust this pinout in verdin_mx8mp.h
-
-Status
-======
-
-  2023-08-23:   The Verdin mx8mp boots into NSH, provides the NSH prompt.
-  2023-09-04:   gpio support, i2c support (tested with on-board ina219 sensor)
diff --git a/Documentation/platforms/arm/mx8mp/boards/verdin-mx8mp/index.rst b/Documentation/platforms/arm/mx8mp/boards/verdin-mx8mp/index.rst
new file mode 100644
index 00000000000..2450f36fb99
--- /dev/null
+++ b/Documentation/platforms/arm/mx8mp/boards/verdin-mx8mp/index.rst
@@ -0,0 +1,26 @@
+=============
+verdin-mx8mp
+=============
+
+This directory provides board support for the Toradex Verdin i.MX8MP. This
+port runs on the internal Cortex-M7 auxiliary core, not on the main
+Cortex-A53 complex.
+
+GPIO Connections
+================
+
+Connect LEDs and buttons to the header pins as follows:
+
+* ``LED21`` on ``GPIO_4``
+* ``LED22`` on ``GPIO_3``
+* ``LED23`` on ``GPIO_2``
+* ``LED24`` on ``GPIO_1``
+* ``SW11`` on ``GPIO_5_CSI``
+
+You can adjust this pin mapping in ``verdin_mx8mp.h``.
+
+Status
+======
+
+* 2023-08-23: boots into NSH and provides the NSH prompt
+* 2023-09-04: GPIO and I2C support work, including the on-board INA219 sensor
diff --git a/Documentation/platforms/arm/mx8mp/index.rst b/Documentation/platforms/arm/mx8mp/index.rst
new file mode 100644
index 00000000000..c9580d53aff
--- /dev/null
+++ b/Documentation/platforms/arm/mx8mp/index.rst
@@ -0,0 +1,16 @@
+=====================
+NXP i.MX 8M Plus
+=====================
+
+Support is available for the NXP i.MX 8M Plus family. Current board support is
+focused on the Cortex-M7 auxiliary core rather than the main Cortex-A53
+application cores.
+
+Supported Boards
+================
+
+.. toctree::
+   :glob:
+   :maxdepth: 1
+
+   boards/*/*