diff --git a/docs/UPGRADING.md b/docs/UPGRADING.md
index 8d57833900c..194c0296332 100644
--- a/docs/UPGRADING.md
+++ b/docs/UPGRADING.md
@@ -530,12 +530,21 @@ breaking changes as needed.
   { "sketch_path": "/tmp/my_sketch" }
   ```
 
+### `config dump` no longer returns default configuration values
+
+Previously, the `config dump` CLI command returned the effective configuration, including both the values explicitly set
+via the configuration file and environment variables as well as the values provided by defaults.
+
+It now only returns the explicitly set configuration data.
+
+Use `config get <configuration key>` to get the effective value of the configuration
+
 ### The gRPC response `cc.arduino.cli.commands.v1.CompileResponse` has been changed.
 
 The `CompilerResponse` message has been refactored to made explicit which fields are intended for streaming the build
 process and which fields are part of the build result.
 
-The old `CompilerResposne`:
+The old `CompilerResponse`:
 
 ```protoc
 message CompileResponse {