diff --git a/UPGRADE-4.4.md b/UPGRADE-4.4.md
index 6590339d84..3409bea3b5 100644
--- a/UPGRADE-4.4.md
+++ b/UPGRADE-4.4.md
@@ -19,6 +19,7 @@ Debug
 -----
 
  * Deprecated the component in favor of the `ErrorHandler` component
+ * Replace uses of `Symfony\Component\Debug\Debug` by `Symfony\Component\ErrorHandler\Debug`
 
 Config
 ------
diff --git a/UPGRADE-5.0.md b/UPGRADE-5.0.md
index 3e67bb5e4d..7e75c9593f 100644
--- a/UPGRADE-5.0.md
+++ b/UPGRADE-5.0.md
@@ -60,6 +60,7 @@ Debug
 -----
 
  * Removed the component in favor of the `ErrorHandler` component
+ * Replace uses of `Symfony\Component\Debug\Debug` by `Symfony\Component\ErrorHandler\Debug`
 
 DependencyInjection
 -------------------