UbiquityRobotics · davecrawley · Apr 23, 2026 · Dec 17, 2025 · Dec 17, 2025 · Dec 24, 2025
diff --git a/README.MD b/README.MD
@@ -14,16 +14,15 @@ The site hosts technical documentation for Ubiquity Robotics robots, covering ha
 
 The documentation is built and deployed automatically using GitHub Actions. The latest version is available at:
 
-<!-- TODO: Change this to the actual website when the repo is switched. -->
-**[https://paveljolak.github.io/learn2/](https://paveljolak.github.io/learn2/)**
+**[https://learn2.ubiquityrobotics.com/jazzy/](https://learn2.ubiquityrobotics.com/jazzy/)**
 
 ## Local Development
 
 To build and run the documentation locally:
 
 <!-- TODO: Add the right links and names for cloning the repository. -->
 ```bash
-git clone https://github.com/Paveljolak/learn2.git
+git clone https://github.com/UbiquityRobotics/learn2.git
 cd learn2
 git fetch --all
 git branch -a

diff --git a/docs/_static/odin_fleet/config_page.png b/docs/_static/odin_fleet/config_page.png
diff --git a/docs/_static/odin_fleet/dashboard_page.png b/docs/_static/odin_fleet/dashboard_page.png
diff --git a/docs/_static/odin_fleet/deleting_queued_tasks.png b/docs/_static/odin_fleet/deleting_queued_tasks.png
diff --git a/docs/_static/odin_fleet/diagnostics_page.png b/docs/_static/odin_fleet/diagnostics_page.png
diff --git a/docs/_static/odin_fleet/dispatching_task.png b/docs/_static/odin_fleet/dispatching_task.png
diff --git a/docs/_static/odin_fleet/feedback_page.png b/docs/_static/odin_fleet/feedback_page.png
diff --git a/docs/_static/odin_fleet/map_visualization.png b/docs/_static/odin_fleet/map_visualization.png
diff --git a/docs/_static/odin_fleet/map_visualization_robot_in_transit.png b/docs/_static/odin_fleet/map_visualization_robot_in_transit.png
diff --git a/docs/_static/odin_fleet/robot_card_idle.png b/docs/_static/odin_fleet/robot_card_idle.png
diff --git a/docs/_static/odin_fleet/robot_card_in_transit.png b/docs/_static/odin_fleet/robot_card_in_transit.png
diff --git a/docs/_static/odin_fleet/robot_decomission.png b/docs/_static/odin_fleet/robot_decomission.png
diff --git a/docs/_static/odin_fleet/robots_list.png b/docs/_static/odin_fleet/robots_list.png
diff --git a/docs/_static/odin_fleet/task_cancelation.png b/docs/_static/odin_fleet/task_cancelation.png
diff --git a/docs/_static/odin_fleet/task_delivery.png b/docs/_static/odin_fleet/task_delivery.png
diff --git a/docs/_static/odin_fleet/task_dispatched.png b/docs/_static/odin_fleet/task_dispatched.png
diff --git a/docs/_static/odin_fleet/task_gotoplace.png b/docs/_static/odin_fleet/task_gotoplace.png
diff --git a/docs/_static/odin_fleet/task_patrol.png b/docs/_static/odin_fleet/task_patrol.png
diff --git a/docs/_static/odin_fleet/task_queue_bin.png b/docs/_static/odin_fleet/task_queue_bin.png
diff --git a/docs/_static/odin_fleet/tasks_list.png b/docs/_static/odin_fleet/tasks_list.png
diff --git a/docs/_static/odin_fleet/tasks_queue.png b/docs/_static/odin_fleet/tasks_queue.png
diff --git a/docs/_static/shutdown/shutdown_GUI.png b/docs/_static/shutdown/shutdown_GUI.png
diff --git a/docs/_static/shutdown/turnedOffRaspberry.jpg b/docs/_static/shutdown/turnedOffRaspberry.jpg
diff --git a/docs/_static/unboxing/Automotive_fuse_battery_diagram.jpg b/docs/_static/unboxing/Automotive_fuse_battery_diagram.jpg
diff --git a/docs/_static/unboxing/batt_to_batt_series_connction_wires.jpg b/docs/_static/unboxing/batt_to_batt_series_connction_wires.jpg
diff --git a/docs/_static/unboxing/batt_to_batt_series_connection.jpg b/docs/_static/unboxing/batt_to_batt_series_connection.jpg
diff --git a/docs/_static/unboxing/batteries_sitting_in_the_battery_bay.jpg b/docs/_static/unboxing/batteries_sitting_in_the_battery_bay.jpg
diff --git a/docs/_static/unboxing/battery_bay_brackets.jpg b/docs/_static/unboxing/battery_bay_brackets.jpg
diff --git a/docs/_static/unboxing/battery_type.jpg b/docs/_static/unboxing/battery_type.jpg
diff --git a/docs/_static/unboxing/connecting_the_batterie_in_series.jpg b/docs/_static/unboxing/connecting_the_batterie_in_series.jpg
diff --git a/docs/_static/unboxing/connecting_the_batteries_in_series2.jpg b/docs/_static/unboxing/connecting_the_batteries_in_series2.jpg
diff --git a/docs/_static/unboxing/one_battery_sitting_in_the_battery_bay.jpg b/docs/_static/unboxing/one_battery_sitting_in_the_battery_bay.jpg
diff --git a/docs/_static/unboxing/snapshot_1773415303723.jpg b/docs/_static/unboxing/snapshot_1773415303723.jpg
diff --git a/docs/_static/unboxing/snapshot_1774619884018.jpg b/docs/_static/unboxing/snapshot_1774619884018.jpg
diff --git a/docs/conf.py b/docs/conf.py
@@ -21,6 +21,7 @@
 # -- General configuration ---------------------------------------------------
 extensions = [
     'sphinx_rtd_theme',
+    'sphinx_design',
     'sphinx.ext.viewcode',
     'sphinx.ext.githubpages',
 ]
@@ -84,8 +85,13 @@
 
 # project_name = project.replace(' ', '_')
 
+# IMPORTANT:
+# ---------------------------------------------------------------------------------------------
+# This part gives error that language does not exists and set it to "None" in the local build process
+# DO NOT CHANGE IT: you will break the version management for the deployed documentation
 html_context['current_language'] = ''
 html_context['language'] = ''
+# ---------------------------------------------------------------------------------------------
 
 # -- "Edit on GitHub" links --------------------------------------------------
 html_context['display_github'] = True

diff --git a/docs/conf.py.orig b/docs/conf.py.orig
@@ -14,7 +14,7 @@ sys.path.insert(0, os.path.abspath('../src'))
 # -- Project information -----------------------------------------------------
 project = 'Ubiquity Robotics Documentation'
 copyright = '2025, Ubiquity Robotics'
-author = 'Pavel for now'
+author = 'Paveljolak'
 version = ''
 release = '1.0.0'
 
@@ -36,6 +36,14 @@ pygments_style = None
 html_theme = 'sphinx_rtd_theme'
 html_static_path = ['_static']
 
+html_logo = "_static/logos/UbiquityRobotics_Logo_Full_White.png"
+
+html_css_files = [
+    'custom.css'
+]
+
+html_js_files = ['custom.js']
+
 # -- RTD lower-left menu setup -----------------------------------------------
 try:
     html_context
@@ -45,7 +53,8 @@ except NameError:
 html_context['display_lower_left'] = True
 
 # Repo and environment info
-REPO_NAME = os.environ.get('REPO_NAME', '')
+full_repo = os.environ.get('GITHUB_REPOSITORY', '')
+REPO_NAME = full_repo.split('/')[-1] 
 OWNER = os.environ.get('OWNER', '') 
 
 # Use ALL_VERSIONS from workflow environment
@@ -56,10 +65,19 @@ current_version = os.environ.get('CURRENT_BRANCH') or (ALL_VERSIONS[0] if ALL_VE
 html_context['current_version'] = current_version
 html_context['version'] = current_version
 
+
 # Base URL for GitHub Pages
-GITHUB_PAGES_BASE = f"https://{OWNER}.github.io/{REPO_NAME}"
 
-# Set versions for selector with absolute URLs
+# Get the custom domain 
+CUSTOM_DOMAIN = os.environ.get("CUSTOM_DOMAIN", "")
+
+# If the DOMAIN exists in the workflow then use it
+if CUSTOM_DOMAIN:
+    GITHUB_PAGES_BASE = f"https://{REPO_NAME}.{CUSTOM_DOMAIN}"
+else:
+    GITHUB_PAGES_BASE = f"https://{OWNER}.github.io/{REPO_NAME}"# Set versions for selector with absolute URLs
+
+# Build the absolute URLs for each version
 html_context['versions'] = [
     (v, f"{GITHUB_PAGES_BASE}/{v}/") for v in ALL_VERSIONS
 ]
@@ -71,8 +89,7 @@ html_context['language'] = ''
 
 # -- "Edit on GitHub" links --------------------------------------------------
 html_context['display_github'] = True
-html_context['github_user'] = ''
+html_context['github_user'] = OWNER
 html_context['github_repo'] = REPO_NAME
 html_context['github_version'] = f'{current_version}/docs/'
 
-
diff --git a/docs/driving/connecting.rst b/docs/driving/connecting.rst
@@ -135,6 +135,15 @@ Example:
 
 | 
 
+.. tip::
+
+    If the robot cannot find your local network, first list nearby Wi-Fi networks from the robot:
+
+    .. code-block:: bash
+
+        nmcli device wifi list
+
+    If your local Wi-Fi (SSID) does not appear in the list, restart the robot and try the connection process again.
 
 .. .. important:: 
 

diff --git a/docs/driving/shutdown.rst b/docs/driving/shutdown.rst
@@ -0,0 +1,44 @@
+Shutting Down the Robot
+=======================
+
+Step 1: Choose Robot Shutdown Method
+####################################
+
+You can shut down the robot either from the GUI or from a terminal session connected to the robot.
+
+Method 1: Shutdown from GUI
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. image:: /_static/shutdown/shutdown_GUI.png
+    :alt: Shutdown from GUI
+    :width: 600px
+    :align: center
+
+|
+
+Method 2: Shutdown from Terminal
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+Open a terminal session connected to the robot (see :doc:`./connecting` for details) and run:
+
+.. code-block:: bash
+
+    sudo shutdown -h now
+
+Step 2: Wait for Shutdown Complete
+##################################
+
+After issuing the shutdown command or selecting the shutdown option from the GUI, wait until the Raspberry Pi LED turns red. 
+This indicates the system has fully shut down and all data has been safely written.
+
+.. image:: /_static/shutdown/turnedOffRaspberry.jpg
+    :alt: Raspberry Pi LED turned red (shutdown complete)
+    :width: 600px
+    :align: center
+
+|
+
+Step 3: Power Off the Robot
+###########################
+
+Once the Raspberry Pi LED is red, turn the robot off using the on/off switch.
diff --git a/docs/ez_map/ez_map_guide.rst b/docs/ez_map/ez_map_guide.rst
@@ -62,10 +62,25 @@ The EZ-Map interface is available on the following webpage:
 
     http://<ROBOT-IP>:3000
 
+Alternatively, you can use the robot's hostname (where ``XXXX`` is your robot's unique ID):
+
+.. code-block:: bash
+
+    http://ubiquityrobotXXXX.local:3000
+
 .. note:: 
 
    This ``ROBOT-IP`` is the same IP that you used to connect to the robot. 
    If you followed the :doc:`../driving/connecting` properly then you should have this IP.
+   The hostname method may or may not work depending on your network's DNS or mDNS configuration.
+
+
+.. danger::
+
+   **CHECK YOUR BROWSER ADDRESS BAR!** 
+
+   Modern browsers (like Chrome or Safari) often automatically force an ``https://`` connection. 
+   EZ-Map **requires** ``http://`` to function. If the page does not load, or you see a "Connection Refused" error, manually change the ``https://`` back to ``http://`` in your address bar.
 
 
 .. warning::

diff --git a/docs/index.rst b/docs/index.rst
@@ -34,15 +34,19 @@ Sections
 
 |  
 
-- `Driving the Robot <driving_>`_: Learn how to operate your robot in the most basic way possible. How to drive it through Teleop and through our custom sofware EZ-Map.
+- `Driving the Robot <driving_>`_: Learn how to operate your robot in the most basic way possible. How to drive it through Teleop and through our custom sofware EZ-Map. This section also includes advanced motor parameter configuration.
 
 |  
 
 - `EZ-Map <ez_map_>`_: Our custom SLAM software for automating your robot. Includes installation, setup, and usage instructions.
 
 |  
 
-- `Troubleshooting <troubleshooting_>`_: Solutions to common hardware and software issues. Your first stop if you encounter problems.
+- `OdinFleet <odin_fleet_>`_: Our custom OdinFleet software for managing fleets through a web dashboard, build on top of Open-RMF.
+
+|
+
+- `Let's get technical <troubleshooting_>`_: Solutions to common hardware and software issues. Your first stop if you encounter problems.
 
 ----
 
@@ -85,6 +89,7 @@ Sections
    driving/connecting
    driving/teleop
    driving/ez_map_simple_drive
+   driving/shutdown
 
 
 .. _ez_map:
@@ -96,14 +101,32 @@ Sections
    ez_map/ez_map_intro
    ez_map/ez_map_guide
 
+
+.. _odin_fleet:
+
+.. toctree:: 
+   :maxdepth: 2
+   :caption: OdinFleet 
+
+   odin_fleet/odin_fleet_intro
+   odin_fleet/odin_fleet_guide
+
+
 .. _troubleshooting:
 
 .. toctree:: 
    :maxdepth: 2
-   :caption: Troubleshooting
+   :caption: Let's get Technical
 
    troubleshooting/hardware/lidars
    troubleshooting/hardware/rpi
    troubleshooting/hardware/pi_camera
+   troubleshooting/hardware/motor_parameters
+
+.. _troubleshooting_tips:
 
+.. toctree:: 
+   :maxdepth: 2
+   :caption: Troubleshooting
 
+   troubleshooting/troubleshooting_tips