docs: add instruction in upgrade note

user_guide_src/source/changelogs/v4.4.0.rst

@@ -45,12 +45,13 @@ Interface Changes
 Method Signature Changes
 ========================
 
+.. _v440-parameter-type-changes:
+
+Parameter Type Changes
+----------------------
+
 - **Services:** The first parameter of ``Services::security()`` has been
   changed from ``Config\App`` to ``Config\Security``.
-- **Routing:** The third parameter ``Routing $routing`` has been added to
-  ``RouteCollection::__construct()``.
-- **Validation:** The method signature of ``Validation::check()`` has been changed.
-  The ``string`` typehint on the ``$rule`` parameter was removed.
 - **Session:** The second parameter of ``Session::__construct()`` has been
   changed from ``Config\App`` to ``Config\Session``.
 - **Session:** The first parameter of ``__construct()`` in ``BaseHandler``,
@@ -59,6 +60,18 @@ Method Signature Changes
 - **Security:** The first parameter of ``Security::__construct()`` has been
   changed from ``Config\App`` to ``Config\Security``.
 
+Added Parameters
+----------------
+
+- **Routing:** The third parameter ``Routing $routing`` has been added to
+  ``RouteCollection::__construct()``.
+
+Removed Parameters
+------------------
+
+- **Validation:** The method signature of ``Validation::check()`` has been changed.
+  The ``string`` typehint on the ``$rule`` parameter was removed.
+
 Enhancements
 ************
 

user_guide_src/source/installation/upgrade_440.rst

@@ -66,6 +66,17 @@ Interface Changes
 Some interface changes have been made. Classes that implement them should update
 their APIs to reflect the changes. See :ref:`v440-interface-changes` for details.
 
+Method Signature Changes
+========================
+
+Some method signature changes have been made. Classes that extend them should
+update their APIs to reflect the changes. See :ref:`v440-method-signature-changes`
+for details.
+
+Also, the parameter types of some constructors and ``Services::security()`` have changed.
+If you call them with the parameters, change the parameter values.
+See :ref:`v440-parameter-type-changes` for details.
+
 RouteCollection::$routes
 ========================
 
@@ -75,13 +86,6 @@ performance.
 If you extend ``RouteCollection`` and use the ``$routes``, update your code to
 match the new array structure.
 
-Method Signature Changes
-========================
-
-Some method signature changes have been made. Classes that extend them should
-update their APIs to reflect the changes. See :ref:`v440-method-signature-changes`
-for details.
-
 Mandatory File Changes
 **********************