wpilibsuite · Kevin-OConnor · Nov 1, 2024 · Oct 28, 2024 · Oct 28, 2024 · Oct 29, 2024
diff --git a/poetry.lock b/poetry.lock
diff --git a/pyproject.toml b/pyproject.toml
@@ -27,6 +27,7 @@ modern-sphinx-version-warning = "==1.1.6"
 sphinxcontrib-htmlhelp = "==2.1.0"
 sphinxcontrib-serializinghtml = "==2.0.0"
 sphinxcontrib-svg2pdfconverter = "==1.2.2"
+sphinxcontrib-video = "==0.2.1"
 sphinxext-delta = "==0.2.0"
 sphinxext-mimic = "==0.1.1"
 sphinxext-opengraph = "==0.9.0"

diff --git a/source/_static/css/frc-rtd.css b/source/_static/css/frc-rtd.css
@@ -38,6 +38,15 @@
 	width: 320px;
 }
 
+/*
+* Prevent video containers from spilling over the edges of the main panel.
+* This matches the built-in style for `.rst-content img`
+*/
+.rst-content video {
+	max-width: 100%;
+	height: auto;
+}
+
 .document img {
 	margin-bottom: 10px;
 }

diff --git a/source/conf.py b/source/conf.py
@@ -41,6 +41,7 @@
     "sphinx.ext.autosectionlabel",
     "sphinx.ext.intersphinx",
     "sphinxcontrib.rsvgconverter",
+    "sphinxcontrib.video",
     "sphinxext.delta",
     "sphinxext.opengraph",
     "sphinxext.photofinish",

diff --git a/source/docs/beta/tasks/task-4-new-features.rst b/source/docs/beta/tasks/task-4-new-features.rst
@@ -10,6 +10,8 @@ The purpose of this task is to test any newly developed or heavily modified feat
 
 **All languages**
 
+- Use the new A-Stop functionality built into the :doc:`Driver Station's Practice mode </docs/software/driverstation/driver-station>`.
+
 **LabVIEW**
 
 **Java**

diff --git a/source/docs/software/driverstation/driver-station.rst b/source/docs/software/driverstation/driver-station.rst
@@ -21,6 +21,21 @@ The FRC Driver Station can be launched by double-clicking the icon on the Deskto
   * :kbd:`[` + :kbd:`]` + :kbd:`\\` - Enable the robot (the 3 keys above Enter on most keyboards)
   * :kbd:`Enter` - Disable the Robot
   * :kbd:`Space` - Emergency Stop the robot. After an emergency stop is triggered the roboRIO will need to be rebooted before the robot can be enabled again.
+  * :kbd:`Backspace` - "A-Stop" the robot when in Practice Mode - Autonomous Enabled. The robot will be disabled until the Practice Mode reaches Teleop then will be automatically re-enabled. While disabled, the application background will flash orange indicating the robot will re-enable automatically.
+
+.. only:: html
+
+   .. video:: images/driver-station/ds-astop.mp4
+      :loop:
+      :width: 900
+      :autoplay:
+      :muted:
+      :alt: Driver Station flashing yellow in A-Stop mode
+
+.. only:: not html
+
+    .. image:: images/driver-station/ds-astop.png
+       :alt: Driver Station flashing yellow in A-Stop mode
 
 .. note:: Space bar will E-Stop the robot regardless of if the Driver Station window has focus or not
 

diff --git a/source/docs/software/driverstation/images/driver-station/ds-astop.mp4 b/source/docs/software/driverstation/images/driver-station/ds-astop.mp4
diff --git a/source/docs/software/driverstation/images/driver-station/ds-astop.png b/source/docs/software/driverstation/images/driver-station/ds-astop.png
diff --git a/source/requirements.txt b/source/requirements.txt
@@ -86,6 +86,7 @@ sphinxcontrib-jsmath==1.0.1 ; python_version >= "3.9" and python_version < "3.13
 sphinxcontrib-qthelp==2.0.0 ; python_version >= "3.9" and python_version < "3.13"
 sphinxcontrib-serializinghtml==2.0.0 ; python_version >= "3.9" and python_version < "3.13"
 sphinxcontrib-svg2pdfconverter==1.2.2 ; python_version >= "3.9" and python_version < "3.13"
+sphinxcontrib-video==0.2.1 ; python_version >= "3.9" and python_version < "3.13"
 sphinxext-delta==0.2.0 ; python_version >= "3.9" and python_version < "3.13"
 sphinxext-mimic==0.1.1 ; python_version >= "3.9" and python_version < "3.13"
 sphinxext-opengraph==0.9.0 ; python_version >= "3.9" and python_version < "3.13"