From 9f0ef3256893e9b156f4ecd2404b0b26296ac36c Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Benjamin=20Cab=C3=A9?= <benjamin@zephyrproject.org>
Date: Mon, 21 Oct 2024 15:18:26 +0200
Subject: [PATCH] boards: weact: adopt new zephyr:board directive and role
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

This updates the documentation of all the WeAct boards
to use the new `zephyr:board::` directive.

Signed-off-by: Benjamin Cabé <benjamin@zephyrproject.org>
---
 boards/weact/blackpill_f401cc/doc/index.rst         |   9 +--------
 boards/weact/blackpill_f401ce/doc/index.rst         |   9 +--------
 boards/weact/blackpill_f411ce/doc/index.rst         |   9 +--------
 .../doc/img/{stm32h7xx.webp => mini_stm32h743.webp} | Bin
 boards/weact/mini_stm32h743/doc/index.rst           |  11 +----------
 boards/weact/stm32f405_core/doc/index.rst           |   9 +--------
 boards/weact/stm32g431_core/doc/index.rst           |   5 +----
 7 files changed, 6 insertions(+), 46 deletions(-)
 rename boards/weact/mini_stm32h743/doc/img/{stm32h7xx.webp => mini_stm32h743.webp} (100%)

diff --git a/boards/weact/blackpill_f401cc/doc/index.rst b/boards/weact/blackpill_f401cc/doc/index.rst
index 79e30862e87ad57..ff6ef271f700b80 100644
--- a/boards/weact/blackpill_f401cc/doc/index.rst
+++ b/boards/weact/blackpill_f401cc/doc/index.rst
@@ -1,7 +1,4 @@
-.. _blackpill_f401cc:
-
-WeAct Studio Black Pill V1.2
-############################
+.. zephyr:board:: blackpill_f401cc
 
 Overview
 ********
@@ -12,10 +9,6 @@ This is the 48-pin variant of the STM32F401x series,
 see `STM32F401x reference manual`_. More info about the board available
 `here <stm32-base-board-page_>`_ and on `WeAct Github`_.
 
-.. image:: img/blackpill-v3.jpg
-      :align: center
-      :alt: Black Pill V3.0+
-
 Hardware
 ********
 
diff --git a/boards/weact/blackpill_f401ce/doc/index.rst b/boards/weact/blackpill_f401ce/doc/index.rst
index eb4983577ae13fd..aa81976e7d90d16 100644
--- a/boards/weact/blackpill_f401ce/doc/index.rst
+++ b/boards/weact/blackpill_f401ce/doc/index.rst
@@ -1,7 +1,4 @@
-.. _blackpill_f401ce:
-
-WeAct Studio Black Pill V3.0
-############################
+.. zephyr:board:: blackpill_f401ce
 
 Overview
 ********
@@ -12,10 +9,6 @@ This is the 48-pin variant of the STM32F401x series,
 see `STM32F401x reference manual`_. More info about the board available
 `here <stm32-base-board-page_>`_ and on `WeAct Github`_.
 
-.. image:: img/blackpill-v3.jpg
-      :align: center
-      :alt: Black Pill V3.0+
-
 Hardware
 ********
 
diff --git a/boards/weact/blackpill_f411ce/doc/index.rst b/boards/weact/blackpill_f411ce/doc/index.rst
index f190d7ea64a0df5..f045f331b8656ed 100644
--- a/boards/weact/blackpill_f411ce/doc/index.rst
+++ b/boards/weact/blackpill_f411ce/doc/index.rst
@@ -1,7 +1,4 @@
-.. _blackpill_f411ce:
-
-WeAct Studio Black Pill V2.0
-############################
+.. zephyr:board:: blackpill_f411ce
 
 Overview
 ********
@@ -12,10 +9,6 @@ This is the 48-pin variant of the STM32F411x series,
 see `STM32F411x reference manual`_. More info about the board available
 `here <stm32-base-board-page_>`_ and on `WeAct Github`_.
 
-.. image:: img/blackpill-v2.jpg
-      :align: center
-      :alt: Black Pill V2.0+
-
 Hardware
 ********
 
diff --git a/boards/weact/mini_stm32h743/doc/img/stm32h7xx.webp b/boards/weact/mini_stm32h743/doc/img/mini_stm32h743.webp
similarity index 100%
rename from boards/weact/mini_stm32h743/doc/img/stm32h7xx.webp
rename to boards/weact/mini_stm32h743/doc/img/mini_stm32h743.webp
diff --git a/boards/weact/mini_stm32h743/doc/index.rst b/boards/weact/mini_stm32h743/doc/index.rst
index 1b71f8a17c2fc96..9dc96700d5bc9d2 100644
--- a/boards/weact/mini_stm32h743/doc/index.rst
+++ b/boards/weact/mini_stm32h743/doc/index.rst
@@ -1,7 +1,4 @@
-.. _mini_stm32h743:
-
-WeAct Studio MiniSTM32H743 Core Board
-#####################################
+.. zephyr:board:: mini_stm32h743
 
 Overview
 ********
@@ -27,12 +24,6 @@ Key Features
    - SWD header for external debugger
    - 2x 40-pin GPIO connector
 
-.. figure:: img/stm32h7xx.webp
-      :align: center
-      :alt: MiniSTM32H743 Core Board
-
-      MiniSTM32H743 Core Board (Credit: WeAct Studio)
-
 More information about the board can be found on the `Mini_STM32H743 website`_.
 
 Hardware
diff --git a/boards/weact/stm32f405_core/doc/index.rst b/boards/weact/stm32f405_core/doc/index.rst
index e08ec5cb7873875..3afc69b79d01e2c 100644
--- a/boards/weact/stm32f405_core/doc/index.rst
+++ b/boards/weact/stm32f405_core/doc/index.rst
@@ -1,7 +1,4 @@
-.. _weact_stm32f405_core:
-
-WeAct Studio STM32F405 Core Board V1.0
-######################################
+.. zephyr:board:: weact_stm32f405_core
 
 Overview
 ********
@@ -12,10 +9,6 @@ This is the 64-pin variant of the STM32F405x series,
 see `STM32F405x reference manual`_. More info about the board available
 on `WeAct Github`_.
 
-.. image:: img/stm32f405_core.jpg
-      :align: center
-      :alt: STM32F405 Core Board v1.0
-
 Hardware
 ********
 
diff --git a/boards/weact/stm32g431_core/doc/index.rst b/boards/weact/stm32g431_core/doc/index.rst
index bf6f80009d502cf..862398794f60ed1 100644
--- a/boards/weact/stm32g431_core/doc/index.rst
+++ b/boards/weact/stm32g431_core/doc/index.rst
@@ -1,7 +1,4 @@
-.. _weact_stm32g431_core:
-
-WeAct Studio STM32G431 Core Board
-#################################
+.. zephyr:board:: weact_stm32g431_core
 
 The WeAct STM32G431 Core Board is a low-cost bare-bones STM32G431-based development
 board. See the `STM32G431CB website`_ for more information about the MCU. More information