Cosmetic adjustments for the Gazebo part.

Murilo Marinho · Murilo Marinho · commit b653210ba6a2 · 2025-08-11T13:02:11.000Z
diff --git a/docs/source/gazebo/about.rst b/docs/source/gazebo/about.rst
@@ -1,5 +1,9 @@
 .. include:: ../the_topic_is_under_heavy_construction.rst
 
+.. versionadded:: Jazzy
+
+   Added this section.
+
 About :program:`Gazebo`
 =======================
 
diff --git a/docs/source/gazebo/installation.rst b/docs/source/gazebo/installation.rst
@@ -1,17 +1,21 @@
 .. include:: ../the_topic_is_under_heavy_construction.rst
 
+.. versionadded:: Jazzy
+
+   Added this section.
+
 .. _Gazebo installation:
 
 :program:`Gazebo` Installation
 ==============================
 
-The following command will install :program:`Gazebo Harmonic` and all the pairing libraries for :program:`ROS2 Jazzy`.
+The following command will install :program:`Gazebo Harmonic` and all the pairing libraries for :program:`ROS2 Jazzy`. Please do not attempt to install it following another documentation. This could lead to a different version being installed.
 
 .. rli:: https://raw.githubusercontent.com/UoMMScRobotics/SFR_Gazebo/refs/heads/main/install_gazebo.sh
    :language: bash
    :lines: 5-15
 
-Here is the description of the packages we are installing. You can notice that the packages are being used in the commands to add the :program:`Gazebo Harmonic` packages to our :program:`apt` sources.
+Here is the description of the packages we are installing. You can notice that the packages are being used in the commands to add the :program:`Gazebo Harmonic` packages to our :program:`apt` sources. We're just telling :program:`apt` where to find the packages and install those.
 
 ===========================   =================================================================================================================================================
 curl_                         Helps download files from the terminal.
@@ -29,7 +33,7 @@ After installation, :program:`Gazebo Harmonic` can be run with the following com
     gz sim
 
 Which should result in something similar to the following, if the installation went well.
-I would recommend strongly against letting the curiosity get the best of you and clicking on the ``3d_shapes.sdf`` given that it's current freezing all my machines.
+I would recommend strongly against letting the curiosity get the best of you and clicking on the ``3k_shapes.sdf`` given that it's current freezing all my machines.
 Other scenes seem to be working in general.
 
 .. image:: images/screen_quickstart.png
diff --git a/docs/source/gazebo/quickstart.rst b/docs/source/gazebo/quickstart.rst
@@ -1,5 +1,9 @@
 .. include:: ../the_topic_is_under_heavy_construction.rst
 
+.. versionadded:: Jazzy
+
+   Added this section.
+
 Using :program:`Gazebo`
 =======================
 
diff --git a/docs/source/index.rst b/docs/source/index.rst
@@ -159,11 +159,13 @@ If you enjoyed this tutorial, please
    inspecting_services
 
 .. toctree::
-   :caption: Gazebo Basics
+   :caption: Gazebo
    :maxdepth: 2
    :hidden:
 
+   gazebo/about
    gazebo/installation
+   gazebo/quickstart
 
 .. toctree::
    :caption: ROS2 C++ Basics
diff --git a/docs/source/parameters_and_launch.rst b/docs/source/parameters_and_launch.rst
@@ -1,5 +1,5 @@
-Parameters: creating configurable Nodes
-=======================================
+Parameters and launch files: creating configurable Nodes
+========================================================
 
 The Nodes we have made in the past few sections are interesting because they take advantage of the interprocess communication provided by ROS2. 
 
