Merge pull request #1807 from jasonrandrews/review

Update ROS 2 install guide

Author: jasonrandrews

content/install-guides/ros2.md

@@ -1,5 +1,5 @@
 ---
-title: ROS2
+title: ROS - Robot Operating System
 author: Odin Shen
 minutes_to_complete: 30
 official_docs: https://www.ros.org/blog/getting-started/
@@ -12,7 +12,6 @@ test_maintenance: true
 
 additional_search_terms:
 - linux
-- cloud
 
 layout: installtoolsall
 multi_install: false
@@ -21,14 +20,14 @@ tool_install: true
 weight: 1
 ---
 
-The Robot Operating System [ROS](https://www.ros.org/) is a set of software libraries and tools for building robot applications.
+The Robot Operating System ([ROS](https://www.ros.org/)) is a set of software libraries and tools for building robot applications.
 ROS 2 is the latest version, designed to enhance security, improve distributed system communication, and support real-time performance, addressing some of the limitations of ROS 1.
 
 ## Before you begin
 
-ROS2 is available for Ubuntu Linux 22.04, 24.04 and Windows 11. 
+ROS 2 is available for Ubuntu Linux 22.04, 24.04, and Windows.
 
-This article provides a quick solution to install ROS2 for Ubuntu on Arm.
+This article provides a quick solution to install ROS 2 for Ubuntu on Arm. You can use Ubuntu 22.04 LTS or Ubuntu 24.04 LTS. 
 
 Confirm you are using an Arm machine by running:
 
@@ -44,51 +43,89 @@ aarch64
 
 If you see a different result, you are not using an Arm computer running 64-bit Linux.
 
-## How do I Install ROS2 for Ubuntu on Arm?
+## What are the ROS 2 dependencies?
 
-We will install ROS 2 using APT.
-By default, the Ubuntu package lists do not include ROS 2, so you need to manually execute the setup first.
+First, install the general dependencies:
 
 ```bash
 sudo apt update
-sudo apt install curl -y
+sudo apt install curl software-properties-common build-essential -y
+```
+
+## How do I Install ROS 2 for Ubuntu on Arm?
+
+You can install ROS 2 using the APT package manager.
+
+The Ubuntu package lists do not include ROS 2, so you need to add the repository. 
+
+```bash
 sudo curl -sSL https://raw.githubusercontent.com/ros/rosdistro/master/ros.key -o /usr/share/keyrings/ros-archive-keyring.gpg
 echo "deb [arch=$(dpkg --print-architecture) signed-by=/usr/share/keyrings/ros-archive-keyring.gpg] http://packages.ros.org/ros2/ubuntu $(lsb_release -cs) main" | sudo tee /etc/apt/sources.list.d/ros2.list > /dev/null
+sudo apt update
 ```
 
-There are two of distros (Jazzy Jalisco and Humble Hawksbill) can be installed depended on your Ubuntu version.
-For Ubuntu Linux 24.04, you should use Jazzy Jalisco.
-For Ubuntu Linux 22.04, you should use Humble Hawksbill.
+Install the ROS 2 dependencies:
+
+```bash
+sudo apt install -y \
+        python3-pip \
+        python3-rosdep \
+        python3-colcon-common-extensions
+```
+
+There are two releases of ROS 2, Jazzy Jalisco and Humble Hawksbill, which you can install based on your Ubuntu version.
+
+- For Ubuntu Linux 24.04, you should install Jazzy Jalisco.
+- For Ubuntu Linux 22.04, you should install Humble Hawksbill.
+
+## How can I install ROS 2?
+
+Install ROS 2 based on your Ubuntu version:
 
 {{< tabpane code=true >}}
   {{< tab header="Ubuntu 24.04" language="bash">}}
-    sudo apt update
-    sudo apt install ros-jazzy-desktop
-    sudo apt install ros-jazzy-ros-base
-    source /opt/ros/jazzy/setup.bash
+    # Install ROS2 packages
+    sudo apt install -y ros-jazzy-desktop
+    # Initialize rosdep
+    sudo rosdep init
+    rosdep update
   {{< /tab >}}
   {{< tab header="Ubuntu 22.04" language="bash">}}
-    sudo apt update
-    sudo apt install ros-humble-desktop
-    sudo apt install ros-humble-ros-base
-    sudo apt install ros-dev-tools
-    source /opt/ros/humble/setup.bash
+    # Install ROS2 packages
+    sudo apt install -y ros-humble-desktop
+    # Initialize rosdep
+    sudo rosdep init
+    rosdep update
   {{< /tab >}}
 {{< /tabpane >}}
 
-Confirm the version `ros2` is installed by using printenv:
+## How do I configure the environment?
 
-```bash
+Add ROS 2 setup to your shell startup script:
+
+{{< tabpane code=true >}}
+  {{< tab header="Ubuntu 24.04" language="bash">}}
+    echo "source /opt/ros/jazzy/setup.bash" >> ~/.bashrc
+    source ~/.bashrc
+  {{< /tab >}}
+  {{< tab header="Ubuntu 22.04" language="bash">}}
+    echo "source /opt/ros/humble/setup.bash" >> ~/.bashrc
+    source ~/.bashrc
+  {{< /tab >}}
+{{< /tabpane >}}
+
+Confirm ROS 2 is installed by using printenv:
+
+```console
 printenv ROS_DISTRO
 ```
 The output should print either `jazzy` or `humble`, depending on your Ubuntu version.
 
-
-## Quick test on ROS2
+## How can I test the ROS 2 installation? 
 
 In one terminal run a `talker`:
 
-```bash
+```console
 ros2 run demo_nodes_cpp talker
 ```
 
@@ -107,20 +144,14 @@ The output will continue to be similar to the one shown below, indicating that R
 ...
 ```
 
-Then, open another terminal source the setup file and then run `listener`:
-{{< tabpane code=true >}}
-  {{< tab header="Ubuntu 24.04" language="bash">}}
-    source /opt/ros/jazzy/setup.bash
-    ros2 run demo_nodes_cpp listener
-  {{< /tab >}}
-  {{< tab header="Ubuntu 22.04" language="bash">}}
-    source /opt/ros/humble/setup.bash
-    ros2 run demo_nodes_cpp listener
-  {{< /tab >}}
-{{< /tabpane >}}
 
-If you see "I heard [Hello World: ]" in second terminal shown below, it's mean your ROS2 has been successfully installed.
-You are now ready to use ROS2.
+Then, open another terminal and run the `listener`:
+
+```console
+ros2 run demo_nodes_cpp listener
+```
+
+If you see "I heard [Hello World: ]" in the second terminal as shown below, it means ROS 2 has been successfully installed.
 
 ```output
 [INFO] [1741389927.137762134] [listener]: I heard: [Hello World: 1]
@@ -134,3 +165,10 @@ You are now ready to use ROS2.
 [INFO] [1741389935.125036222] [listener]: I heard: [Hello World: 9]
 ...
 ```
+
+You are now ready to use ROS 2.
+
+## Where can I learn more about ROS 2?
+
+- Explore the [ROS 2 Tutorials](https://docs.ros.org/en/jazzy/Tutorials.html)
+- Learn about [ROS 2 Command Line Tools](https://docs.ros.org/en/jazzy/Concepts/About-Command-Line-Tools.html)

data/stats_current_test_info.yml

@@ -146,6 +146,10 @@ sw_categories:
     rust_embedded:
       readable_title: Rust for Embedded Applications
       tests_and_status: []
+    ros2:
+      readable_title: ROS2
+      tests_and_status:
+      - ubuntu:latest: passed
     ssh:
       readable_title: SSH
       tests_and_status: []