diff --git a/UPGRADE-3.3.md b/UPGRADE-3.3.md
index 47745b8ed7531..5e2d6460b5e5a 100644
--- a/UPGRADE-3.3.md
+++ b/UPGRADE-3.3.md
@@ -255,6 +255,12 @@ HttpFoundation
 HttpKernel
 -----------
 
+ * Deprecated the `kernel.root_dir` parameter. Use the new `kernel.project_dir`
+   parameter instead.
+
+ * Deprecated the `Kernel::getRootDir()` method. Use the new `Kernel::getProjectDir()`
+   method instead.
+
  * The `Extension::addClassesToCompile()` method has been deprecated and will be removed in 4.0.
 
  * The `Psr6CacheClearer::addPool()` method has been deprecated. Pass an array
diff --git a/UPGRADE-4.0.md b/UPGRADE-4.0.md
index ae350cc67b4bd..f5f50df5df62d 100644
--- a/UPGRADE-4.0.md
+++ b/UPGRADE-4.0.md
@@ -366,6 +366,12 @@ HttpFoundation
 HttpKernel
 ----------
 
+ * Removed the `kernel.root_dir` parameter. Use the `kernel.project_dir` parameter
+   instead.
+
+ * Removed the `Kernel::getRootDir()` method. Use the `Kernel::getProjectDir()`
+   method instead.
+
  * The `Extension::addClassesToCompile()` method has been removed.
 
  * Possibility to pass non-scalar values as URI attributes to the ESI and SSI