diff --git a/docs/development/firmware/building.mdx b/docs/development/firmware/building.mdx
index 18b0a10b..c666a882 100644
--- a/docs/development/firmware/building.mdx
+++ b/docs/development/firmware/building.mdx
@@ -22,6 +22,17 @@ Meshtastic uses [PlatformIO](https://platformio.org), a development environment
    If you want to build the RP2040 targets and get a 'Filename too long' error on Windows, please refer to [the Platformio documentation for this toolchain](https://arduino-pico.readthedocs.io/en/latest/platformio.html#important-steps-for-windows-users-before-installing)
    :::
 
+ ## Update the Build Environment
+
+1. Change to `firmware` folder
+   ```shell
+   cd firmware
+   ```
+2. Gather the latest changes to the [Meshtastic Firmware](https://github.com/meshtastic/firmware) repository and [submodules](https://github.com/meshtastic/firmware/blob/master/.gitmodules)
+   ```shell
+   git pull --recurse-submodules
+   ```
+
 ## Build
 
 1. Open the newly cloned folder in [Visual Studio Code](https://code.visualstudio.com). If you do this for the first time, this can take quite some while as PlatformIO will download all the necessary tooling and libraries. Also if platformio is not installed, VSCode will ask you to install it, probably requiring a restart of the program.