diff --git a/UPGRADE-2.3.md b/UPGRADE-2.3.md
index 445e460a05..cba8a0541b 100644
--- a/UPGRADE-2.3.md
+++ b/UPGRADE-2.3.md
@@ -184,3 +184,22 @@ DomCrawler
        return $crawler->text();
    });
    ```
+
+Console
+-------
+
+ * New verbosity levels have been added, therefore if you used to do check
+   the output verbosity level directly for VERBOSITY_VERBOSE you probably
+   want to update it to a greater than comparison:
+
+   Before:
+
+   ```
+   if (OutputInterface::VERBOSITY_VERBOSE === $output->getVerbosity()) { ... }
+   ```
+
+   After:
+
+   ```
+   if (OutputInterface::VERBOSITY_VERBOSE <= $output->getVerbosity()) { ... }
+   ```
diff --git a/src/Symfony/Component/Console/CHANGELOG.md b/src/Symfony/Component/Console/CHANGELOG.md
index 1a82efaf17..e4213af338 100644
--- a/src/Symfony/Component/Console/CHANGELOG.md
+++ b/src/Symfony/Component/Console/CHANGELOG.md
@@ -10,6 +10,7 @@ CHANGELOG
  * added a way to normalize EOLs in `ApplicationTester::getDisplay()` and `CommandTester::getDisplay()`
  * added a way to set the progress bar progress via the `setCurrent` method
  * added support for multiple InputOption shortcuts, written as `'-a|-b|-c'`
+ * added two additional verbosity levels, VERBOSITY_VERY_VERBOSE and VERBOSITY_DEBUG
 
 2.2.0
 -----