Sub: use-cases: add videos, improve sidebar visibility

ES-Alexander · Hwurzburg · commit 2c666eb5d978 · 2026-04-18T14:48:21.000-05:00
diff --git a/common/source/docs/common-use-cases-and-applications.rst b/common/source/docs/common-use-cases-and-applications.rst
@@ -16,11 +16,49 @@ Use Cases
 
 .. image:: ../../../images/case-sub.jpg
 
+- Observation and exploration
+
+.. youtube:: T_FMx7C5P_8
+   :width: 100%
+
+- Wreck discovery and documenting
+
+.. youtube:: BV91zgzEFHs
+   :width: 100%
+
+- Photography and videography
+
+.. youtube:: 8IOn9yDXBLM
+   :width: 100%
+
+- Boat, equipment, and infrastructure inspection
+
+.. youtube:: LCWA_9RFQ24
+   :width: 100%
+
+- Biological sampling and surveying
+
+.. youtube:: t6J94qbZqKk
+   :width: 100%
+
+- Underwater retrieval
+
+.. youtube:: _tzUh62LPjA
+   :width: 100%
+
+- Academic and research projects
+
+.. youtube:: X8CUwg6_y7E
+   :width: 100%
+
+- ROV and AUV competitions
 
 - Bathymetry Boat
 
 .. image:: ../../../images/case-boat.jpg
 
+.. youtube:: p24jFOGKxb8
+   :width: 100%
 
 - Autonomous Mowers and Tractors
 
@@ -32,10 +70,8 @@ Use Cases
 .. image:: ../../../images/case-cmu-nrec-drone.png
 
 
-..  youtube:: k6jKkpmj4-k
-    :width: 640
-    :height: 480
-
+.. youtube:: k6jKkpmj4-k
+   :width: 100%
 
 .. toctree::
     :maxdepth: 1
diff --git a/sub/source/docs/additional-information.rst b/sub/source/docs/additional-information.rst
@@ -11,6 +11,5 @@ Additional Information and Topics of Interest
     Upcoming Features <common-master-features>
     Ready to Swim/Use Vehicles <common-rtf>
     OEM Customization <common-oem-customizations>
-    Use Cases and Applications <common-use-cases-and-applications>
     Web Tools <https://firmware.ardupilot.org/Tools/WebTools/>
     Appendix <common-appendix>
diff --git a/sub/source/docs/introduction.rst b/sub/source/docs/introduction.rst
@@ -4,6 +4,12 @@
 Introduction to Sub
 ===================
 
+.. toctree::
+   :maxdepth: 1
+   :hidden:
+
+   common-use-cases-and-applications
+
 Sub is an advanced open-source autopilot system for submersible ROVs (Remote Operated Vehicle) that supports multiple vehicle configurations. It offers a variety of operating modes from fully manual to fully autonomous, and is designed to be safe, feature-rich, open-ended, and easy to use even for novice users. 
 
 .. image:: ../images/sub-system.jpg
@@ -50,3 +56,4 @@ Sub provides access to many functionalities through its fine-grained :ref:`param
 * Optional Buoyancy Control instead of vertical thrusters/neutral buoyancy
 
 **No programming is required** for standard operation, but highly detailed interfaces are available for programmatic control (including :ref:`MAVLink commands<dev:mavlink-commands>`), and the autopilot firmware can be freely modified and extended (including through dynamically loaded :ref:`common-lua-scripts`).
+
