diff --git a/doc/index.rst b/doc/index.rst
index 153bb26165..91f965d601 100644
--- a/doc/index.rst
+++ b/doc/index.rst
@@ -33,14 +33,3 @@ Concepts
    Controller Chaining / Cascade Control <../controller_manager/doc/controller_chaining.rst>
    Hardware Components <../hardware_interface/doc/hardware_components_userdoc.rst>
    Mock Components <../hardware_interface/doc/mock_components_userdoc.rst>
-
-
-================
-Migration Guides
-================
-
-.. toctree::
-   :titlesonly:
-
-   Foxy to Galactic <migration/Foxy.rst>
-   Iron to Jazzy <migration/Iron.rst>
diff --git a/doc/migration/Iron.rst b/doc/migration/Iron.rst
index 0ae7446903..21e28fc43f 100644
--- a/doc/migration/Iron.rst
+++ b/doc/migration/Iron.rst
@@ -2,7 +2,8 @@ Iron to Jazzy
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
 component parser
-**************************************
+*****************
+Changes from `(PR #1256) <https://github.com/ros-controls/ros2_control/pull/1256>`__
 
 * All ``joints`` defined in the ``<ros2_control>``-tag have to be present in the URDF received :ref:`by the controller manager <doc/ros2_control/controller_manager/doc/userdoc:subscribers>`, otherwise a ``std::runtime_error`` is thrown. This is to ensure that the URDF and the ``<ros2_control>``-tag are consistent. E.g., for configuration ports use ``gpio`` tags instead.
 * The syntax for mimic joints is changed to the `official URDF specification <https://wiki.ros.org/urdf/XML/joint>`__. The parameters within the ``ros2_control`` tag are not supported any more. Instead of