revamped board support page

Author: gonzolively

docs/board-support/ST/index.md

@@ -9,8 +9,9 @@ has_children: true
 
 STMicroelectronics development boards offer an excellent platform for working with the Ocre runtime. This section covers our currently supported ST boards and the recommended development tools for working with them.
 
-## Recommended Tools
-* **[STM32CubeProg](https://www.st.com/en/development-tools/stm32cubeprog.html)**: Official programming utility for flashing and configuring STM32 devices
-* **[STM32CubeIDE](https://www.st.com/en/development-tools/stm32cubeide.html)**: Integrated development environment that combines STM32CubeMX and STM32CubeProg functionalities with a full-featured code editor and debugger
+## Required Tools
+Before working with any STM32 board, you must install:
+* **[STM32CubeProgrammer](https://www.st.com/en/development-tools/stm32cubeprog.html)**: Official programming utility required for flashing firmware and configuring STM32 devices.
 
-For board-specific setup instructions and features, please refer to the individual board pages below. 
+## Supported Boards
+Select your board below for detailed setup and usage instructions.

docs/board-support/index.md

@@ -4,17 +4,26 @@ layout: default
 has_children: true
 nav_order: 6 
 ---
-
 # Board Support
-The Ocre runtime supports various development boards, each offering different features and capabilities. Each board's documentation provides:
+The Ocre runtime supports various development boards, each offering different features and capabilities. 
+
+---
+
+## Using this Documentation
+1. First, select your board's manufacturer in the **sidebar** to review required tools and setup instructions specific to that manufacturer's development boards
+2. After installing the necessary tools, find your specific board's documentation for detailed hardware setup and flashing instructions
+
+**Each board's documentation provides:**
 - Hardware specifications and features
 - Connection and setup instructions
 - Flashing procedures
 - Reset and recovery steps
 - Relevant board documentation links
 
-Select your boards manufacturer in the **sidebar** to the left, and subsequently your specific board for detailed setup and usage instructions for your board.
+{: .important}
+Make sure to review and install all required tools outlined in the manufacturer's page before proceeding to your specific board's instructions. For example, STMicroelectronics boards require STM32CubeProgrammer for flashing firmware.
+
+---
 
 ## Adding Board Support
-If your board isn't listed in our supported devices, check out the [Adding Board Support](../board-support/adding-support) guide in the sidebar. This guide walks you through the process of adding support for new development boards to the Ocre runtime.
-I've:
+If your board isn't listed in our supported devices, check out the [Adding Board Support](../board-support/adding-support) guide in the sidebar. This guide walks you through the process of adding support for new development boards to the Ocre runtime.