[skip changelog] Update UPGRADING.md with new breaking changes

docs/UPGRADING.md

@@ -37,3 +37,33 @@ The `debug.xxx=yyy` definitions above may be supplied and overlayed in the usual
 - on `platform.txt`: definition here will be shared through all boards in the platform
 - on `boards.txt` as part of a board definition: they will override the global platform definitions
 - on `programmers.txt`: they will override the boards and global platform definitions if the programmer is selected
+
+### Binaries export must now be explicitly specified
+
+Previously, if the `--build-path` was not specified, compiling a Sketch would copy the generated binaries in
+`<sketch_folder>/build/<fqbn>/`, uploading to a board required that path to exist and contain the necessary binaries.
+
+The `--dry-run` flag is removed, `compile` now never copies generated binaries to the sketch folder. The
+`--export-binaries` (`-e`) flag is introduced to copy the binaries from the build folder to the sketch one. Specifying
+the `--output-dir` doesn't require using setting also the `--export-binaries` flag. A related settings and env var has
+been added to avoid the need to always specify the `--export-binaries` flag: `sketch.always_export_binaries` and
+`ARDUINO_SKETCH_ALWAYS_EXPORT_BINARIES`.
+
+If `--input-dir` or `--input-file` is not set when calling `upload` the command will search for the deterministically
+created build directory in the temp folder and use the binaries found there.
+
+The gRPC interface has been updated accordingly, `dryRun` is removed.
+
+### Programmers can't be listed anymore using `burn-bootloader -P list`
+
+The `-P` flags is meant to select the programmer used to burn the bootloader on the specified board, the `-P list` was
+an hackish way to list all the possible programmers that could be used for that board.
+
+This way has been removed in favour of `board details <fqbn> --list-programmers`.
+
+### `lib install --git-url` and `--zip-file` must now be esplicitly enabled
+
+With the introduction of the `--git-url` and `--zip-file` flags the new config key `library.enable_unsafe_install` has
+been added to enable them.
+
+This changes the ouput of the `config dump` command.