Add Route Server Tools documentation and Nav2 Route Tool tutorial

Signed-off-by: bekirbostanci <bekirbostanci@gmail.com>

Author: bekirbostanci

tutorials/docs/route_server_tools.rst

@@ -0,0 +1,36 @@
+.. _route_server_tools:
+
+Route Server Tools
+##################
+
+Route Server tools are essential components in the Nav2 ecosystem that help users create, edit, and manage route graphs for robot navigation. A route graph is a representation of valid paths that a robot can follow in its environment, consisting of nodes (waypoints) and edges (connections between waypoints). These tools simplify the process of defining preferred paths and restricted areas for robot navigation.
+
+Unlike free-space planning, route-based navigation ensures that robots follow specific, predefined paths, which is particularly useful in:
+- Industrial environments where specific routes must be followed
+- Warehouse operations requiring structured movement patterns
+- Facilities with restricted areas or preferred paths
+- Multi-robot coordination scenarios where predefined routes help prevent conflicts
+
+Provided Tools
+**************
+
+.. toctree::
+  :maxdepth: 1
+
+  route_server_tools/navigation2_route_tool.rst
+  route_server_tools/route_graph_generation_lif_editor.rst
+  route_server_tools/route_graph_generation.rst
+
+Description
+***********
+
+There are several tools available for creating and editing route graphs for the Nav2 Route Server:
+
+1. **Nav2 Route Tool**: An Rviz panel that allows users to create, edit, and manage route graphs directly within the ROS 2 environment. It supports loading existing graphs, adding/editing/removing nodes and edges, and saving changes to files.
+
+2. **VDA LIF Editor**: A web-based tool that allows users to create route graphs using floor plan images. It can generate both GeoJSON and LIF formats, making it particularly useful for standardized route creation. No installation is required as it runs in a web browser.
+
+3. **Manual Route Graph Generation**: For those who prefer direct file editing, route graphs can be created manually in GeoJSON format. This method provides the most control over the graph structure but requires understanding of the GeoJSON format.
+
+Choose the tool that best fits your needs based on your workflow and requirements.
+

tutorials/docs/navigation2_route_tool.rst …_server_tools/navigation2_route_tool.rsttutorials/docs/navigation2_route_tool.rst renamed to tutorials/docs/route_server_tools/navigation2_route_tool.rst tutorials/docs/navigation2_route_tool.rst renamed to tutorials/docs/route_server_tools/navigation2_route_tool.rst

@@ -15,18 +15,19 @@ Nav2 Tutorials
    docs/using_groot.rst
    docs/integrating_vio.rst
    docs/navigation2_dynamic_point_following.rst
-   docs/navigation2_route_tool.rst
    docs/navigation2_with_keepout_filter.rst
    docs/navigation2_with_speed_filter.rst
    docs/using_docking.rst
    docs/using_shim_controller.rst
    docs/adding_smoother.rst
    docs/using_collision_monitor.rst
-   docs/route_graph_generation_lif_editor.rst
-   docs/route_graph_generation.rst
    docs/adding_a_nav2_task_server.rst
    docs/filtering_of_noise-induced_obstacles.rst
    docs/camera_calibration.rst
    docs/get_backtrace.rst
    docs/get_profile.rst
    docs/docker_dev.rst
+   docs/route_server_tools.rst
+   docs/route_server_tools/navigation2_route_tool.rst
+   docs/route_server_tools/route_graph_generation_lif_editor.rst
+   docs/route_server_tools/route_graph_generation.rst