address review comments.

Signed-off-by: Tomoya Fujita <[email protected]>
Co-authored-by: Christophe Bedard <[email protected]>

Author: fujitatomoya

source/Concepts/Intermediate/About-Composition.rst

@@ -33,29 +33,28 @@ By making the process layout a deploy-time decision the user can choose between:
 
 Additionally ``ros2 launch`` can be used to automate these actions through specialized launch actions.
 
-Component container
+.. _ComponentContainerTypes:
+
+Component Container
 -------------------
 
-Component container is a host process that allows you to load and manage multiple components at runtime within the same process space.
-This enables better performance and memory efficiency because it avoids inter-process communication overhead when nodes interact.
+A component container is a host process that allows you to load and manage multiple components at runtime within the same process space.
 
-As of now, these are generic component container types available.
+As of now, the following generic component container types are available:
 
 * `component_container <https://github.com/ros2/rclcpp/blob/{REPOS_FILE_BRANCH}/rclcpp_components/src/component_container.cpp>`__
 
-  * The most generic component container that uses a single ``SingleThreadedExecutor`` to execute all components including component container itself.
+  * The most generic component container that uses a single ``SingleThreadedExecutor`` to execute all components.
 
 * `component_container_mt <https://github.com/ros2/rclcpp/blob/{REPOS_FILE_BRANCH}/rclcpp_components/src/component_container_mt.cpp>`__
 
-  * Component container that uses a single ``MultiThreadedExecutor`` to execute the components including component container itself.
-  * ``thread_num`` parameter option is available to specify the number of threads in ``MultiThreadedExecutor``.
+  * Component container that uses a single ``MultiThreadedExecutor`` to execute the components.
 
 * `component_container_isolated <https://github.com/ros2/rclcpp/blob/{REPOS_FILE_BRANCH}/rclcpp_components/src/component_container_isolated.cpp>`__
 
-  * Component container with dedicated either ``SingleThreadedExecutor`` (default) or  ``MultiThreadedExecutor`` executors for each component. (Component container is executed by ``SingleThreadedExecutor``)
-  * ``--use_multi_threaded_executor`` argument specifies executor type used for each component to ``MultiThreadedExecutor``.
+  * Component container that uses a dedicated executor for each component: either ``SingleThreadedExecutor`` (default) or ``MultiThreadedExecutor``.
 
-See more details for :doc:`Types of Executors <../../Concepts/Intermediate/About-Executors>`.
+For more information about the types of executors, see the :ref:`TypesOfExecutors`.
 
 Writing a Component
 -------------------

source/Concepts/Intermediate/About-Executors.rst

@@ -59,6 +59,8 @@ The *wait set* is also used to detect when timers expire.
 
 The Single-Threaded Executor is also used by the container process for :doc:`components <./About-Composition>`, i.e. in all cases where nodes are created and executed without an explicit main function.
 
+.. _TypesOfExecutors:
+
 Types of Executors
 ------------------
 

source/Tutorials/Intermediate/Composition.rst

@@ -210,29 +210,31 @@ Advanced Topics
 
 Now that we have seen the basic operation of components, we can discuss a few more advanced topics.
 
-Component container types
+Component Container Types
 ^^^^^^^^^^^^^^^^^^^^^^^^^
 
-As introduced in :doc:`Component container <../../Concepts/Intermediate/About-Composition>`, there is a few component container types with options.
+As introduced in :ref:`ComponentContainerTypes`, there are a few component container types with different options.
 You can choose the most appropriate component container type for your requirement.
 
 * ``component_container`` (No options / parameters available)
 
-.. code-block:: bash
+   .. code-block:: bash
 
-   ros2 run rclcpp_components component_container
+      ros2 run rclcpp_components component_container
 
 * ``component_container_mt`` with ``MultiThreadedExecutor`` composed of 4 threads.
+   * ``thread_num`` parameter option is available to specify the number of threads in ``MultiThreadedExecutor``.
 
-.. code-block:: bash
+   .. code-block:: bash
 
-   ros2 run rclcpp_components component_container_mt --ros-args -p thread_num:=4
+      ros2 run rclcpp_components component_container_mt --ros-args -p thread_num:=4
 
 * ``component_container_isolated`` with ``MultiThreadedExecutor`` for each component.
+   * ``--use_multi_threaded_executor`` argument specifies executor type used for each component to ``MultiThreadedExecutor``.
 
-.. code-block:: bash
+   .. code-block:: bash
 
-   ros2 run rclcpp_components component_container_isolated --use_multi_threaded_executor
+      ros2 run rclcpp_components component_container_isolated --use_multi_threaded_executor
 
 Unloading components
 ^^^^^^^^^^^^^^^^^^^^