Group ROS 2 Project pages under subfolder (ros2#2465)

Author: esthersweon

source/Contact.rst

@@ -55,7 +55,7 @@ Pull requests
 
 When you feel comfortable enough to suggest a specific change directly to the code, you can submit a pull request.
 Pull requests are welcome for any of `the ros2 repositories <https://github.com/ros2>`__.
-See the :doc:`Contributing <Contributing>` page for more details and etiquette on how to contribute.
+See the :doc:`Contributing <The-ROS2-Project/Contributing>` page for more details and etiquette on how to contribute.
 
 .. _Using ROS Discourse:
 

source/How-To-Guides/Package-maintainer-guide.rst

@@ -21,8 +21,8 @@ The review is looking for:
 * Correct code
 * Conforms to developer guidelines:
 
-    * :doc:`Developer Guide <../Contributing/Developer-Guide>`
-    * :doc:`Code Style Guide <../Contributing/Code-Style-Language-Versions>`
+    * :doc:`Developer Guide <../The-ROS2-Project/Contributing/Developer-Guide>`
+    * :doc:`Code Style Guide <../The-ROS2-Project/Contributing/Code-Style-Language-Versions>`
 
 * Adds tests for the bug/feature
 * Adds documentation for new features
@@ -178,6 +178,6 @@ Getting help
 
 While doing maintenance on a package, questions about general procedures or individual issues may come up.
 
-For general questions, please follow the :doc:`contributing guidelines <../Contributing>`.
+For general questions, please follow the :doc:`contributing guidelines <../The-ROS2-Project/Contributing>`.
 
 For questions on individual issues, please tag the ROS 2 GitHub team (@ros/team), and someone on the team will take a look.

source/Related-Projects.rst

@@ -10,7 +10,7 @@ Ignition Gazebo
 Large Community Projects
 ------------------------
 
-Large community projects involve multiple developers from all over the globe and are typically backed by a dedicated working group (cf. :doc:`Governance`).
+Large community projects involve multiple developers from all over the globe and are typically backed by a dedicated working group (cf. :doc:`The-ROS2-Project/Governance`).
 
 * **Navigation2** `(navigation.ros.org) <https://navigation.ros.org/>`_: Comprehensive and flexible navigation stack for mobile robots using ROS 2.
 * **MoveIt** `(moveit.ros.org) <https://moveit.ros.org/>`_: A rich platform for building manipulation applications featuring advanced kinematics, motion planning, control, collision checking, and much more.

source/Releases.rst

@@ -143,7 +143,7 @@ Rows in the table marked in green are the currently supported distributions.
 Future Distributions
 --------------------
 
-For details on upcoming features see the :doc:`roadmap <Roadmap>`.
+For details on upcoming features see the :doc:`roadmap <The-ROS2-Project/Roadmap>`.
 
 There is a new ROS 2 distribution released yearly on May 23rd (`World Turtle Day <https://www.worldturtleday.org/>`_).
 
@@ -171,7 +171,7 @@ The Rolling distribution of ROS 2 serves as a staging area for future stable dis
 Unlike most stable ROS 2 distributions which have an initial release, a support window during which they are updated, and a definite end of support (see :ref:`list_of_distributions` above) the Rolling distribution is continuously updated and is subject to in-place updates which will at times include breaking changes.
 
 Packages released into the Rolling distribution will be automatically released into future stable distributions of ROS 2.
-:doc:`Releasing a ROS 2 package <How-To-Guides/Releasing-a-ROS-2-package-with-bloom>` into the Rolling distribution follows the same procedures as all other ROS 2 distributions.
+:doc:`Releasing a ROS 2 package <../How-To-Guides/Releasing-a-ROS-2-package-with-bloom>` into the Rolling distribution follows the same procedures as all other ROS 2 distributions.
 
 :doc:`ROS 2 Rolling Ridley <Releases/Release-Rolling-Ridley>` is the rolling development distribution of ROS 2 as proposed in `REP 2002 <https://www.ros.org/reps/rep-2002.html>`_.
 It was first introduced in June 2020.

source/Releases/Alpha-Overview.rst

@@ -1,25 +1,25 @@
 .. redirect-from::
 
-    Alpha-Overview
+   Alpha-Overview
 
-ROS 2 alpha releases (Aug 2015 - Oct 2016)
-==========================================
+Alphas
+======
 
 .. contents:: Table of Contents
    :depth: 2
    :local:
 
 This is a merged version of the previously separated pages for the 8 alpha releases of ROS 2.
 
-We hope that you try them out and `provide feedback <../Contact>`.
+We hope that you try them out and `provide feedback <../../Contact>`.
 
 ROS 2 alpha8 release (code name *Hook-and-Loop*; October 2016)
 ----------------------------------------------------------------
 
 Changes to supported DDS vendors
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-ROS 2 supports multiple middleware implementations (see `this page <../Concepts/About-Different-Middleware-Vendors>` for more details).
+ROS 2 supports multiple middleware implementations (see `this page <../../Concepts/About-Different-Middleware-Vendors>` for more details).
 Until Alpha 8, ROS 2 was supporting ROS middleware implementations for eProsima's Fast RTPS, RTI's Connext and PrismTech's OpenSplice.
 To streamline our efforts, as of Alpha 8, Fast RTPS and Connext (static) will be supported, with Fast RTPS (`now Apache 2.0-licensed <http://www.eprosima.com/index.php/company-all/news/61-eprosima-goes-apache>`__) shipped as the default.
 
@@ -43,7 +43,7 @@ The improvements included in this release are:
 * Fixed various bugs with the previous alpha release
 
 Pretty much anything not listed above is not included in this release.
-The next steps are described in the `Roadmap <../Roadmap>`.
+The next steps are described in the `Roadmap <../../The-ROS2-Project/Roadmap>`.
 
 ROS 2 alpha7 release (code name *Glue Gun*\ ; July 2016)
 --------------------------------------------------------
@@ -76,7 +76,7 @@ The major features included in this release are:
   * See: https://github.com/ros2/turtlebot2_demo
 
 Pretty much anything not listed above is not included in this release.
-The next steps are described in the `Roadmap <../Roadmap>`.
+The next steps are described in the `Roadmap <../../The-ROS2-Project/Roadmap>`.
 
 ROS 2 alpha6 release (code name *Fastener*; June 2016)
 ------------------------------------------------------
@@ -111,7 +111,7 @@ The major features included in this release are:
   * Strings
 
 Pretty much anything not listed above is not included in this release.
-The next steps are described in the `Roadmap <../Roadmap>`.
+The next steps are described in the `Roadmap <../../The-ROS2-Project/Roadmap>`.
 
 ROS 2 alpha5 release (code name *Epoxy*; April 2016)
 ------------------------------------------------------
@@ -139,7 +139,7 @@ The major features included in this release are:
 * Added 32-bit and 64-bit ARM as experimentally supported platforms.
 
 Pretty much anything not listed above is not included in this release.
-The next steps are described in the `Roadmap <../Roadmap>`.
+The next steps are described in the `Roadmap <../../The-ROS2-Project/Roadmap>`.
 
 ROS 2 alpha4 release (code name *Duct tape*; February 2016)
 -----------------------------------------------------------
@@ -165,11 +165,11 @@ Status
 On February 17, 2016, we are releasing ROS 2 alpha4,
 code-named **Duct tape**.
 Our primary goal with this release is to add more features, while also addressing the feedback we received for the previous releases.
-To that end, we built a set of `demos <../Tutorials>` that
+To that end, we built a set of `demos <../../Tutorials>` that
 show some of the key features of ROS 2.
 We encourage you to try out those
 demos, look at the code that implements them, and `provide
-feedback <../Contact>`.
+feedback <../../Contact>`.
 We're especially interested to know how well (or
 poorly) we're addressing use cases that are important to you.
 
@@ -200,7 +200,7 @@ The major features included in this release are:
   * New concept of extensible "time sources" for ROS Time, the default time source will be like ROS 1 (implementation pending)
 
 Pretty much anything not listed above is not included in this release.
-The next steps are described in the `Roadmap <../Roadmap>`.
+The next steps are described in the `Roadmap <../../The-ROS2-Project/Roadmap>`.
 
 ROS 2 alpha3 release (code name *Cement*; December 2015)
 ----------------------------------------------------------
@@ -227,11 +227,11 @@ Status
 On December 18, 2015, we are releasing ROS 2 alpha3,
 code-named **Cement**.
 Our primary goal with this release is to add more features, while also addressing the feedback we received for the previous releases.
-To that end, we built a set of `demos <../Tutorials>` that
+To that end, we built a set of `demos <../../Tutorials>` that
 show some of the key features of ROS 2.
 We encourage you to try out those
 demos, look at the code that implements them, and `provide
-feedback <../Contact>`.
+feedback <../../Contact>`.
 We're especially interested to know how well (or
 poorly) we're addressing use cases that are important to you.
 
@@ -271,7 +271,7 @@ The major features included in this release are:
 * A partial port of tf2 including the core libraries and core command line tools.
 
 Pretty much anything not listed above is not included in this release.
-The next steps are described in the `Roadmap <../Roadmap>`.
+The next steps are described in the `Roadmap <../../The-ROS2-Project/Roadmap>`.
 
 ROS 2 alpha2 release (code name *Baling wire*; October 2015)
 --------------------------------------------------------------
@@ -300,11 +300,11 @@ Status
 On November 3, 2015, we are releasing ROS 2 alpha2,
 code-named **Baling wire**.
 Our primary goal with this release is to add more features, while also addressing the feedback we received for the previous alpha 1 release.
-To that end, we built a set of `demos <../Tutorials>` that
+To that end, we built a set of `demos <../../Tutorials>` that
 show some of the key features of ROS 2.
 We encourage you to try out those
 demos, look at the code that implements them, and `provide
-feedback <../Contact>`.
+feedback <../../Contact>`.
 We're especially interested to know how well (or
 poorly) we're addressing use cases that are important to you.
 
@@ -336,7 +336,7 @@ The major features included in this release are:
 * FreeRTPS improvements
 
 Pretty much anything not listed above is not included in this release.
-The next steps are described in the `Roadmap <../Roadmap>`.
+The next steps are described in the `Roadmap <../../The-ROS2-Project/Roadmap>`.
 
 ROS 2 alpha1 release (code name *Anchor*; August 2015)
 --------------------------------------------------------
@@ -367,11 +367,11 @@ code-named **Anchor**.
 Our primary goal with this release is to give
 you the opportunity to understand how ROS 2 works, in particular how it
 differs from ROS 1.
-To that end, we built a set of `demos <../Tutorials>` that
+To that end, we built a set of `demos <../../Tutorials>` that
 show some of the key features of ROS 2.
 We encourage you to try out those
 demos, look at the code that implements them, and `provide
-feedback <../Contact>`.
+feedback <../../Contact>`.
 We're especially interested to know how well (or
 poorly) we're addressing use cases that are important to you.
 
@@ -408,4 +408,4 @@ The major features included in this release are:
 * `Bridge communication between ROS 1 and ROS 2 <https://github.com/ros2/ros1_bridge/blob/master/README>`__
 
 Pretty much anything not listed above is not included in this release.
-The next steps are described in the `Roadmap <../Roadmap>`.
+The next steps are described in the `Roadmap <../../The-ROS2-Project/Roadmap>`.

source/Releases/Beta1-Overview.rst

@@ -1,9 +1,9 @@
 .. redirect-from::
 
-    Beta1-Overview
+  Beta1-Overview
 
-Beta 1 (codename 'Asphalt'; December 2016)
-==========================================
+Beta 1 (``Asphalt``)
+====================
 
 .. contents:: Table of Contents
    :depth: 2
@@ -24,13 +24,13 @@ Improvements since Alpha 8 release
 * A standard lifecycle for managed nodes.
 * Improved support for Quality of Service tuning and tests.
 * `New and updated design documents <https://design.ros2.org/>`__
-* More `tutorials <../Tutorials>` and `examples <https://github.com/ros2/examples>`__
+* More `tutorials <../../Tutorials>` and `examples <https://github.com/ros2/examples>`__
 * Bridging services to / from ROS 1 (in addition to topics)
 
 Selected features from previous Alpha releases
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-For the complete list, see `earlier release notes <../Releases>`.
+For the complete list, see `earlier release notes <../index>`.
 
 
 * C++ and Python implementations of ROS 2 client libraries including APIs for:

source/Releases/Beta2-Overview.rst

@@ -1,9 +1,9 @@
 .. redirect-from::
 
-    Beta2-Overview
+  Beta2-Overview
 
-Beta 2 (codename 'r2b2'; July 2017)
-===================================
+Beta 2 (``r2b2``)
+=================
 
 .. contents:: Table of Contents
    :depth: 2
@@ -13,7 +13,7 @@ Supported Platforms
 -------------------
 
 We support ROS 2 Beta 2 on three platforms: Ubuntu 16.04 (Xenial), macOS 10.12 (Sierra), and Windows 10.
-We provide both binary packages and instructions for how to compile from source for all 3 platforms (see `install instructions <../Installation>` as well as `documentation <https://docs.ros2.org/beta2/>`__).
+We provide both binary packages and instructions for how to compile from source for all 3 platforms (see `install instructions <../../Installation>` as well as `documentation <https://docs.ros2.org/beta2/>`__).
 
 Features
 --------
@@ -23,9 +23,9 @@ Improvements since Beta 1 release
 
 * DDS_Security support (aka SROS2, see `sros2 <https://github.com/ros2/sros2>`__)
 * Debian packages for Ubuntu Xenial
-* Typesupport has been redesigned so that you only build a single executable and can choose one of the available RMW implementations by setting an environment variable (see `documentation <../How-To-Guides/Working-with-multiple-RMW-implementations>`).
+* Typesupport has been redesigned so that you only build a single executable and can choose one of the available RMW implementations by setting an environment variable (see `documentation <../../How-To-Guides/Working-with-multiple-RMW-implementations>`).
 * Namespace support for nodes and topics (see `design article <https://design.ros2.org/articles/topic_and_service_names.html>`__, see known issues below).
-* A set of command-line tools using the extensible ``ros2`` command (see `conceptual article <../Concepts/About-Command-Line-Tools>`).
+* A set of command-line tools using the extensible ``ros2`` command (see `conceptual article <../../Concepts/About-Command-Line-Tools>`).
 * A set of macros for logging messages in C / C++ (see API docs of `rcutils <https://docs.ros2.org/beta2/api/rcutils/index.html>`__).
 
 New demo application
@@ -52,7 +52,7 @@ New demo application
 Selected features from previous Alpha/Beta releases
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-For the complete list, see `earlier release notes <../Releases>`.
+For the complete list, see `earlier release notes <../index>`.
 
 
 * C++ and Python implementations of ROS 2 client libraries including APIs for:

source/Releases/Beta3-Overview.rst

@@ -1,9 +1,9 @@
 .. redirect-from::
 
-    Beta3-Overview
+  Beta3-Overview
 
-Beta 3 (codename 'r2b3'; September 2017)
-========================================
+Beta 3 (``r2b3``)
+=================
 
 .. contents:: Table of Contents
    :depth: 2
@@ -13,7 +13,7 @@ Supported Platforms
 -------------------
 
 We support ROS 2 Beta 3 on three platforms: Ubuntu 16.04 (Xenial), macOS 10.12 (Sierra), and Windows 10.
-We provide both binary packages and instructions for how to compile from source for all 3 platforms (see `install instructions <../Installation>` as well as `documentation <https://docs.ros2.org/beta3/>`__).
+We provide both binary packages and instructions for how to compile from source for all 3 platforms (see `install instructions <../../Installation>` as well as `documentation <https://docs.ros2.org/beta3/>`__).
 
 Features
 --------
@@ -41,7 +41,7 @@ New demo application
 Selected features from previous Alpha/Beta releases
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
 
-For the complete list, see `earlier release notes <../Releases>`.
+For the complete list, see `earlier release notes <../index>`.
 
 * C++ and Python implementations of ROS 2 client libraries including APIs for:
 

source/Releases/Galactic-Geochelone-Complete-Changelog.rst

@@ -1,5 +1,5 @@
-ROS 2 Galactic Geochelone Complete Changelog
-============================================
+Galactic Geochelone changelog
+=============================
 
 This page is a list of the complete changes in all ROS 2 core packages since the previous release.
 

source/Releases/Humble-Hawksbill-Complete-Changelog.rst

@@ -1,5 +1,5 @@
-ROS 2 Humble Hawksbill Complete Changelog
-=========================================
+Humble Hawksbill changelog
+==========================
 
 This page is a list of the complete changes in all ROS 2 core packages since the previous release.