Update compiler flags for debugging and enhance development guide structure

Author: gemenerik

cmake/gcc-arm-none-eabi.cmake

@@ -28,9 +28,9 @@ set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} ${TARGET_FLAGS}")
 set(CMAKE_ASM_FLAGS "${CMAKE_C_FLAGS} -x assembler-with-cpp -MMD -MP")
 set(CMAKE_C_FLAGS "${CMAKE_C_FLAGS} -Wall -Wextra -Wpedantic -fdata-sections -ffunction-sections")
 
-set(CMAKE_C_FLAGS_DEBUG "-O0 -g3")
+set(CMAKE_C_FLAGS_DEBUG "-Og -g3")  # Optimize for debugging on constrained 32KB flash
 set(CMAKE_C_FLAGS_RELEASE "-Os -g0")
-set(CMAKE_CXX_FLAGS_DEBUG "-O0 -g3")
+set(CMAKE_CXX_FLAGS_DEBUG "-Og -g3")
 set(CMAKE_CXX_FLAGS_RELEASE "-Os -g0")
 
 set(CMAKE_CXX_FLAGS "${CMAKE_C_FLAGS} -fno-rtti -fno-exceptions -fno-threadsafe-statics")

docs/building-and-flashing/build.md

@@ -1,28 +1,51 @@
 ---
-title: Build
+title: Development Guide
 page_id: build
 ---
 
-## Prerequisites
+## Building
+
+### Prerequisites
+
+- CMake
+- ARM GCC toolchain
+
+### Build Commands
+
+```bash
+cmake --preset Release
+cmake --build build/Release
+```
+
+This will generate the firmware binary at `build/Release/color-led.elf`.
+
+## Flashing
+
+Once built, flash the firmware to the board using probe-rs:
+
+```bash
+probe-rs download --chip stm32c011f6ux build/Release/color-led.elf
+```
+
+## Debugging
+
+For a more advanced development workflow with debugging capabilities:
+
+### Prerequisites
 
 - **VSCode** with the STM32Cube extension (see [.vscode/extensions.json](../../.vscode/extensions.json))
 
 The STM32Cube VSCode extension will automatically install and configure dependencies.
 
-## Setup
+### Setup
 
 1. Clone the repository
 2. Open the project in VSCode
 3. Install the recommended extensions when prompted
 4. The STM32Cube extension will set up the build environment automatically
 
-## Building
-
-- Press `Ctrl+Shift+B` to build
-- Or click the build button in the CMake extension toolbar
-
-## Debugging
+### Debug Session
 
-To flash and debug:
-- Press `F5` to build, flash, and start debugging
-- Or click the debug button in the VSCode debug panel
+To build, flash, and debug in one step:
+- Press `F5` to start a debug session
+- Or click the debug button in the VSCode debug panel