diff --git a/UPGRADING b/UPGRADING
index 7d9b96c273a81..ad26b040c566c 100644
--- a/UPGRADING
+++ b/UPGRADING
@@ -60,6 +60,9 @@ PHP 8.1 UPGRADE NOTES
   . Most non-final internal methods now require overriding methods to declare a
     compatible return type, otherwise a deprecated notice is emitted during
     inheritance validation.
+    In case the return type cannot be declared for an overriding method due to
+    PHP cross-version compatibility concerns, a `#[ReturnTypeWillChange]`
+    attribute can be added to silence the deprecation notice.
     RFC: https://wiki.php.net/rfc/internal_method_return_types
 
 - Fileinfo: