clarifications

Author: softhack007

.github/copilot-instructions.md

@@ -1,6 +1,15 @@
 # WLED-MM — ESP32/ESP8266 LED Controller Firmware
 
-WLED is a fast, feature-rich ESP32/ESP8266 webserver for controlling NeoPixel (WS2812B, WS2811, SK6812) LEDs and SPI-based chipsets. WLED-MM is a fork focused on higher performance (ESP32, ESP32-S3, PSRAM boards), large installs, and advanced audio analysis.
+WLED is a fast, feature-rich ESP32/ESP8266 webserver for controlling NeoPixel (WS2812B, WS2811, SK6812) LEDs and SPI-based chipsets. 
+WLED-MM is a fork focused on higher performance (ESP32, ESP32-S3, PSRAM boards), large installs, and advanced audio analysis.
+
+Always reference these instructions first and fallback to search or bash commands only when you encounter unexpected information that does not match the info here.
+
+## Setup
+
+- Node.js 20+ (see `.nvmrc`)
+- Install dependencies: `npm ci`
+- PlatformIO (required only for firmware compilation): `pip install -r requirements.txt`
 
 ## Hardware Targets
 
@@ -11,14 +20,6 @@ WLED is a fast, feature-rich ESP32/ESP8266 webserver for controlling NeoPixel (W
 | ESP32-S2, ESP32-C3 | Supported |
 | ESP8266 | Deprecated — should still compile, but not actively maintained |
 
-Always reference these instructions first and fallback to search or bash commands only when you encounter unexpected information that does not match the info here.
-
-## Setup
-
-- Node.js 20+ (see `.nvmrc`)
-- Install dependencies: `npm ci`
-- PlatformIO (required only for firmware compilation): `pip install -r requirements.txt`
-
 ## Build and Test
 
 | Command | Purpose | Typical Time |

.github/cpp.instructions.md

@@ -244,9 +244,11 @@ uint32_t wg = (((c1 >> 8) & TWO_CHANNEL_MASK) * amount) & ~TWO_CHANNEL_MASK;
 return rb | wg;
 ```
 
-### Bit Shifts Over Division (RISC-V boards)
+### Bit Shifts Over Division (mainly for RISC-V boards)
 
-On most ESP32 variants (Xtensa core), the compiler already converts power-of-two divisions to shifts at `-O2`, so manual shifts rarely help. On RISC-V based ESP32 boards (ESP32-C3, ESP32-C6, ESP32-H2) the compiler may not do this automatically, so explicit shifts can be beneficial:
+ESP32 and ESP32-S3 (Xtensa core) have a fast "integer divide" instruction, so manual shifts rarely help. 
+The compiler already converts power-of-two unsigned divisions to shifts at `-O2`.
+On RISC-V based boards (ESP32-C3, ESP32-C6, ESP32-C5) explicit shifts can be beneficial:
 
 Prefer bit shifts for power-of-two operations: