diff --git a/docs/firmware.md b/docs/firmware.md
index 9c3b8d2..8db55cd 100644
--- a/docs/firmware.md
+++ b/docs/firmware.md
@@ -79,6 +79,9 @@ To add a new parameter:
 
 See examples of adding new parameters in commits: [c434107](https://github.com/okalachev/flix/commit/c434107), [a687303](https://github.com/okalachev/flix/commit/a687303).
 
+> [!NOTE]
+> Since all the parameters are internally stored and passed as floats, the safe range for `int` parameters is -16777216 to 16777215.
+
 ## Adding a subsystem
 
 To add a new subsystem:
diff --git a/docs/usage.md b/docs/usage.md
index 6091668..46e9d82 100644
--- a/docs/usage.md
+++ b/docs/usage.md
@@ -58,7 +58,7 @@ You can build and upload the firmware using either **Arduino IDE** (easier for b
    make upload monitor
    ```
 
-   For ESP32-S3/ESP32-C3 boards, set the appropriate [FQBN](https://arduino.github.io/arduino-cli/1.5/FAQ/#whats-the-fqbn-string) using `BOARD` parameter:
+   For ESP32-S3/ESP32-C3 boards, set the appropriate [FQBN](https://docs.arduino.cc/arduino-cli/FAQ/#whats-the-fqbn-string) using `BOARD` parameter:
 
    ```bash
    make BOARD=esp32:esp32:esp32s3:DebugLevel=error,FlashSize=4M,CDCOnBoot=cdc upload