Updated the structure of Autonomous Robotics (open-edge-platform#2127)

Co-authored-by: Golebiewski, SebastianX <sebastianx.golebiewski@intel.com>

Author: achamuah

robotics-ai-suite/docs/index.rst

@@ -31,12 +31,33 @@ Click each icon to learn more.
 
         Install a Robot Kit.
 
-    .. grid-item-card:: Developer Guide
-        :link: robotics/dev_guide/index
+    .. grid-item-card:: Get Started with Autonomous Mobile Robot
+        :link: robotics/gsg_robot/index
         :link-type: doc
         :link-alt: clickable cards
 
-        Resources to get started with development.
+        Install a Robot Kit.
+
+    .. grid-item-card:: How it works
+        :link: robotics/dev_guide/index_howitworks
+        :link-type: doc
+        :link-alt: clickable cards
+
+        Describes how the software works
+
+    .. grid-item-card:: Tutorials
+        :link: robotics/dev_guide/index_tutorials
+        :link-type: doc
+        :link-alt: clickable cards
+
+        Provides a learning path for developers to use and configure Autonomous Mobile Robot
+
+    .. grid-item-card:: System Integrators
+        :link: robotics/dev_guide/index_systemintegrator
+        :link-type: doc
+        :link-alt: clickable cards
+
+        Information specifically for System Integrators.
 
 Stationary Robot Vision & Control Framework
 **************************************************

robotics-ai-suite/docs/robotics/dev_guide/how_it_works/robot-algorithms.rst

@@ -21,7 +21,7 @@ For details, see `Model Zoo
 ADBSCAN
 ++++++++
 
-**Tutorial**: :doc:`../../dev_guide/tutorials_amr/navigation/adbscan/index`
+**Tutorial**: :doc:` ADBSCAN Algorithm <../tutorials_amr/navigation/adbscan/index>`
 
 
 DBSCAN (Density-Based Spatial Clustering of Applications with Noise) is an
@@ -35,7 +35,7 @@ average.
 3D Pointcloud Groundfloor Segmentation
 ++++++++++++++++++++++++++++++++++++++
 
-**Tutorial**: :doc:`../../dev_guide/tutorials_amr/perception/pointcloud-groundfloor-segmentation`
+**Tutorial**: :doc:` 3D Pointcloud Groundfloor Segmentation for Intel® RealSense™ Camera and 3D LiDAR <../tutorials_amr/perception/pointcloud-groundfloor-segmentation>`
 
 An algorithm, along with a demo application, that transforms (Intel® RealSense™) Depth Camera images to 3D
 pointclouds. This algorithm further assigns classification labels such as 'ground floor' or
@@ -71,7 +71,7 @@ https://github.com/CCNYRoboticsLab/imu_tools:
 FastMapping
 ++++++++++++
 
-**Tutorial**: :doc:`../../dev_guide/tutorials_amr/navigation/run-fastmapping-algorithm`
+**Tutorial**: :doc:` FastMapping Algorithm <../tutorials_amr/navigation/run-fastmapping-algorithm>`
 
 FastMapping, is an algorithm to create a 3D voxel map of a robot's
 surrounding, based on Intel® RealSense™ Depth Camera sensor data.
@@ -80,7 +80,7 @@ surrounding, based on Intel® RealSense™ Depth Camera sensor data.
 Collaborative Visual SLAM
 ++++++++++++++++++++++++++
 
-**Tutorial**: :doc:`../../dev_guide/tutorials_amr/navigation/collaborative-slam`
+**Tutorial**: :doc:` Collaborative Visual SLAM <../tutorials_amr/navigation/collaborative-slam>`
 
 Collaborative visual SLAM is a framework for service robots which utilizes simultaneous localization
 and mapping (SLAM). An edge server maintains a map database and handles global optimization. Each robot can
@@ -165,7 +165,7 @@ The SLAM toolbox is a set of tools and capabilities for 2D SLAM that includes th
 ITS Global Path Planner
 ++++++++++++++++++++++++
 
-**Tutorial**: :doc:`../../dev_guide/tutorials_amr/navigation/its-path-planner-plugin`
+**Tutorial**: :doc:` ITS Path Planner ROS 2 Navigation Plugin <../tutorials_amr/navigation/its-path-planner-plugin>`
 
 The Intelligent Sampling and Two-Way Search (ITS) Global Path Planner is a plugin for the ROS 2 Navigation package.
 It performs a path planning search on a roadmap from two directions
@@ -203,7 +203,7 @@ the integration of GPS data.
 Navigation 2
 +++++++++++++
 
-**Tutorials**: :doc:`../../dev_guide/tutorials_amr/navigation/index`
+**Tutorials**: :doc:` Navigation <../tutorials_amr/navigation/index>`
 
 ROS 2 Navigation stack, which seeks a safe way to have a mobile robot move
 from point A to point B. This completes dynamic path planning, computes

robotics-ai-suite/docs/robotics/dev_guide/index.rst

@@ -1,4 +1,4 @@
-.. |how_it_works| image:: ../../images/icons/How_it_Works.png
+.. |how_it_works| image:: ../images/icons/How_it_Works.png
    :width: 70
    :align: bottom
 
@@ -45,12 +45,12 @@ This diagram shows the software components included in the Autonomous Mobile Rob
 package.
 
 
-.. image:: ../../images/amr_sdk_software_components.png
+.. image:: ../images/amr_sdk_software_components.png
 
 
 The Autonomous Mobile Robot software stack relies on the underlying hardware platform, software supported by and integrated into
 their respective Unified Extensible Firmware Interface (UEFI) based boot processes, and supported Linux
-operating system. For requirement details, see :doc:`../../dev_guide/requirements`.
+operating system. For requirement details, see :doc:`../dev_guide/requirements`.
 
 
 Autonomous Mobile Robot Drivers
@@ -71,10 +71,10 @@ specifically important for Autonomous Mobile Robot include:
 -  The Serial Driver, the serial stream as used in Ethernet and USB interfaces.
 
 
-.. include:: tools.rst
+.. include:: how_it_works/tools.rst
 
-.. include:: robot-apps.rst
+.. include:: how_it_works/robot-apps.rst
 
-.. include:: robot-algorithms.rst
+.. include:: how_it_works/robot-algorithms.rst
 
-.. include:: robot-middleware.rst
+.. include:: how_it_works/robot-middleware.rst

…obotics/dev_guide/how_it_works/index.rst …/robotics/dev_guide/index_howitworks.rstrobotics-ai-suite/docs/robotics/dev_guide/how_it_works/index.rst renamed to robotics-ai-suite/docs/robotics/dev_guide/index_howitworks.rst robotics-ai-suite/docs/robotics/dev_guide/how_it_works/index.rst renamed to robotics-ai-suite/docs/robotics/dev_guide/index_howitworks.rst

@@ -1,4 +1,4 @@
-.. |sys_integrator| image:: ../../images/icons/Integrate.png
+.. |sys_integrator| image:: ../images/icons/Integrate.png
    :width: 70
    :align: bottom
 
@@ -10,7 +10,7 @@ This chapter details information specifically for system integrators.
 .. toctree::
    :maxdepth: 1
 
-   benchmark_profiling/index
-   performance
-   security
+   system_integrator/benchmark_profiling/index
+   system_integrator/performance
+   system_integrator/security
 

…cs/dev_guide/system_integrator/index.rst …ics/dev_guide/index_systemintegrator.rstrobotics-ai-suite/docs/robotics/dev_guide/system_integrator/index.rst renamed to robotics-ai-suite/docs/robotics/dev_guide/index_systemintegrator.rst robotics-ai-suite/docs/robotics/dev_guide/system_integrator/index.rst renamed to robotics-ai-suite/docs/robotics/dev_guide/index_systemintegrator.rst

@@ -0,0 +1,23 @@
+.. |tutorials_robot| image:: ../images/icons/Tutorial_Robot.png
+   :width: 70
+   :align: bottom
+
+.. tutorials-amr:
+
+Tutorials |tutorials_robot|
+===========================
+
+Prerequisite: Follow the instructions in :doc:`../gsg_robot/index`.
+
+With step-by-step instructions covering real world usage scenarios,
+these tutorials provide a learning path for developers to use and configure Autonomous Mobile Robot.
+
+
+.. toctree::
+   :maxdepth: 1
+
+   tutorials_amr/developer_kit/index
+   tutorials_amr/perception/index
+   tutorials_amr/navigation/index
+   tutorials_amr/simulation/index
+   tutorials_amr/robot-tutorials-troubleshooting

robotics-ai-suite/docs/robotics/dev_guide/index_tutorials.rst

@@ -1,6 +1,11 @@
 Autonomous Mobile Robot
 ************************
 
+The Autonomous Mobile Robot provides software packages and pre-validated hardware modules for sensor data ingestion, classification, environment modeling, action planning, action control. Built on the (ROS 2 Humble) robot operating system, it also features reference algorithms and working examples.
+
+Beyond autonomous mobility, this package demonstrates map building and Simultaneous Localization And Mapping (SLAM) loop closure functionality. It utilizes an open source version of visual SLAM with input from an Intel® RealSense™ camera. Optionally, the package allows you to run Light Detection and Ranging (LiDAR) based SLAM and compare those results with visual SLAM results on accuracy and performance indicators. Additionally, it detects and highlights the objects on the map. Depending on the platform that is used, workloads are executed on an integrated GPU or on Intel® CPU.
+
+The Autonomous Mobile Robot addresses industrial, manufacturing, consumer market, and smart cities use cases, facilitating data collection, storage, and analytics across various nodes on the factory floor.
 Develop, build, and deploy end-to-end mobile robot applications with this purpose-built, open, and modular software development kit that includes libraries, middleware, and sample applications based on the open source ROS 2 Humble robot operating system.
 
 Click each icon to learn more.
@@ -14,17 +19,35 @@ Click each icon to learn more.
 
         Install a Robot Kit.
 
-    .. grid-item-card:: Developer Guide
-        :link: dev_guide/index
+    .. grid-item-card:: How it works
+        :link: dev_guide/index_howitworks
+        :link-type: doc
+        :link-alt: clickable cards
+
+        Describes how the software works
+
+    .. grid-item-card:: Tutorials
+        :link: dev_guide/index_tutorials
+        :link-type: doc
+        :link-alt: clickable cards
+
+        Provides a learning path for developers to use and configure Autonomous Mobile Robot
+
+    .. grid-item-card:: System Integrators
+        :link: dev_guide/index_systemintegrator
         :link-type: doc
         :link-alt: clickable cards
 
-        Resources to get started with development.
+        Information specifically for System Integrators.
 
 
 .. toctree::
    :maxdepth: 1
    :hidden:
 
    gsg_robot/index
-   dev_guide/index
+   dev_guide/index_howitworks
+   dev_guide/requirements
+   dev_guide/index_tutorials
+   dev_guide/index_systemintegrator
+   dev_guide/terminology