Add recommendation to update systems before installing ROS 2. (#2581) (…

…#2585) * Add recommendation to update systems before installing ROS 2. Installing ROS 2 packages without updating the system first can lead to conflicts due to package version differences. This is generally useful but of particular importance on Ubuntu Jammy: ros2/ros2#1272 * Add system upgrade admonition to alternative installation methods. * Extract upgrade admonitions into a snippet. * Add upgrade admonitions to alternative installation methods. (cherry picked from commit b4527c0) # Conflicts: # source/Installation/Alternatives/RHEL-Development-Setup.rst # source/Installation/Alternatives/RHEL-Install-Binary.rst # source/Installation/RHEL-Install-RPMs.rst Co-authored-by: Steven! Ragnarök <[email protected]>
ros2 · May 19, 2022 · 155f168 · 155f168
1 parent f4a2884
commit 155f168
Show file tree

Hide file tree

Showing 4 changed files with 13 additions and 0 deletions.
diff --git a/source/Installation/Alternatives/Ubuntu-Development-Setup.rst b/source/Installation/Alternatives/Ubuntu-Development-Setup.rst
@@ -97,6 +97,8 @@ Create a workspace and clone all repos:
 Install dependencies using rosdep
 ---------------------------------
 
+.. include:: ../_Apt-Upgrade-Admonition.rst
+
 .. code-block:: bash
 
    sudo rosdep init

diff --git a/source/Installation/Alternatives/Ubuntu-Install-Binary.rst b/source/Installation/Alternatives/Ubuntu-Install-Binary.rst
@@ -62,6 +62,8 @@ Installing and initializing rosdep
 Installing the missing dependencies
 -----------------------------------
 
+.. include:: ../_Apt-Upgrade-Admonition.rst
+
 Set your rosdistro according to the release you downloaded.
 
 .. code-block:: bash

diff --git a/source/Installation/Ubuntu-Install-Debians.rst b/source/Installation/Ubuntu-Install-Debians.rst
@@ -43,6 +43,8 @@ Update your apt repository caches after setting up the repositories.
 
    sudo apt update
 
+.. include:: _Apt-Upgrade-Admonition.rst
+
 Desktop Install (Recommended): ROS, RViz, demos, tutorials.
 
 .. code-block:: bash

diff --git a/source/Installation/_Apt-Upgrade-Admonition.rst b/source/Installation/_Apt-Upgrade-Admonition.rst
@@ -0,0 +1,7 @@
+ROS 2 packages are built on frequently updated Ubuntu systems.
+It is always recommended that you ensure your system is up to date before installing new packages.
+
+.. code-block:: bash
+
+   sudo apt upgrade
+