Update for 2025

source/conf.py

@@ -36,6 +36,7 @@
     "sphinx.ext.mathjax",
     "sphinx_design",
     "sphinx_favicon",
+    "sphinx_new_tab_link",
     "sphinxext.opengraph",
     "sphinxext.rediraffe",
     "sphinxcontrib.rsvgconverter",
@@ -57,8 +58,6 @@
 
 rst_epilog = """
 .. |gm0| replace:: Game Manual 0
-.. |gm1| replace:: Game Manual Part 1
-.. |gm2| replace:: Game Manual Part 2
 .. |cm| replace:: Competition Manual
 .. |EN| replace:: Engineering Notebook
 """
@@ -345,3 +344,6 @@ def setup(app):
 
 # -- GraphViz configuration ----------------------------------
 graphviz_output_format = 'svg'
+
+# Show icon for external links (https://github.com/ftnext/sphinx-new-tab-link/tree/main?tab=readme-ov-file#new_tab_link_show_external_link_icon)
+new_tab_link_show_external_link_icon = True

source/docs/appendix/gallery.rst

@@ -1,9 +1,9 @@
 Gallery Of Robot Designs
 ========================
 
-Collection of robot designs from past seasons. Feel free to borrow some design solutions for your robot!
+Collection of robot designs from past seasons. Feel free to borrow some design solutions to adapt for your robot!
 
-.. note:: Copying another team's design usually doesn't work if you don't understand why their design works and why they built it that way. Just like copying your friend's homework doesn't mean you learned the material.
+.. note:: Copying another team's design usually doesn't work if you don't understand why their design works and why they built it that way, just like copying your friend's homework doesn't mean you learned the material. Understanding *why* something was designed a certain way is very important.
 
 2024-2025 Into The Deep
 -------------------------

source/docs/appendix/vendor-guide.rst

@@ -16,36 +16,44 @@ Prefix Identification
 SKU Identification
 ^^^^^^^^^^^^^^^^^^
 
-- Actuonix: 3-4 digit SKU, alphanumeric, in the form of XX00 or X00 (i.e. PQ12)
 - goBILDA: 12 digit SKU, numerical, in the form of 0000-0000-0000 (i.e. 3213-3606-0001)
-- Pitsco/Tetrix: 6 digit SKU, W + 5 numbers, in the form of W00000 (i.e. W44260)
 - Servocity/Actobotics: 6 digit SKU, numerical, in the form of 000000 (i.e. 615190)
+- REV: 6 digit SKU, "REV" + 2 numbers + 4 numbers, in the form of REV-00-0000 (i.e. REV-31-1595)
+- Pitsco/Tetrix: 6 digit SKU, W + 5 numbers, in the form of W00000 (i.e. W44260)
+- Actuonix: 3-4 digit SKU, alphanumeric, in the form of XX00 or X00 (i.e. PQ12)
 
 Where can I get ...?
 --------------------
 
+// FIXME: add links to products?
+
 - Motors and Gearboxes
 
-  - Spur Gear Motors
+  - Planetary Gearbox Motors (recommended)
 
-    - :term:`AndyMark NeveRest <NeveRest Motor>` Classic
-    - :term:`REV HD Hex <HD Hex Motor>` & :term:`Core Hex <Core Hex Motor>`
-    - goBILDA 5201 Spur Gear
-    - TETRIX TorqueNado
+    - :term:`goBILDA 5202/5203/5204 Yellow Jacket Planetary <Yellow Jacket Motor>`
+    - :term:`REV HD Hex <HD Hex Motor>` UltraPlanetary
 
-  - Planetary Gearbox Motors (recommended)
+      - (The UltraPlanetary gearboxes have a customizable gearbox ratio)
+    - :term:`AndyMark NeveRest Orbital <NeveRest Motor>`
+    - :term:`AndyMark NeveRest Hex <NeveRest Motor>`
 
-    - :term:`AndyMark NeveRest <NeveRest Motor>` Orbital
-    - :term:`REV HD Hex <HD Hex Motor>` Planetary & *UltraPlanetary*
-    - :term:`goBILDA 5202/5203 Yellow Jacket Planetary <Yellow Jacket Motor>`
-    - (*italicized* = customizable gearbox ratio)
+  - Spur Gearbox Motors (NOT recommended)
+
+    - :term:`REV HD Hex <HD Hex Motor>` & :term:`Core Hex <Core Hex Motor>`
+    - :term:`AndyMark NeveRest Classic <NeveRest Motor>`
+    - TETRIX TorqueNado
 
 - Servos
 
-  - HiTec (from ServoCity); 24 tooth spline
+  - goBILDA servos (all use a 25 tooth spline)
+
+    - Dual Mode Servos
+    - 5-Turn Dual Mode Servos
+    - Proton Servos
+  - Axon Micro, Mini, and Max servos; 25 tooth spline (Note: the Micro uses a smaller B25T spline)
   - REV Smart Robot Servo; 25 tooth spline
-  - Axon Mini & Max; 25 tooth spline
-  - goBILDA Dual Mode Servo; 25 tooth spline
+  - HiTec (from ServoCity); 24 and 25 tooth spline options
   - Futaba (Futaba servos are widely used in RC and hobby aircraft); 25 tooth spline
   - Savox heavy-duty servos; 25 tooth spline
   - Actuonix (linear actuators)
@@ -64,34 +72,31 @@ Where can I get ...?
 
 - Aluminum Components
 
-  - Actobotics :term:`channel <Channel>`, mini :term:`channel <Channel>`, X-rail :term:`extrusion <Extrusion>`
+  - goBILDA :term:`channel <Channel>`, goRAIL :term:`extrusion <Extrusion>`, goTUBE
   - REV extrusion, C :term:`channel <Channel>`, U :term:`channel <Channel>`
-  - goBILDA :term:`channel <Channel>`, goRAIL :term:`extrusion <Extrusion>`
   - TETRIX :term:`channel <Channel>`
   - MiSUMI :term:`extrusion <Extrusion>`
 
 - Gears/Sprockets/Pulleys
 
-  - REV :term:`gears <Gear>`, :term:`sprockets <Sprocket>`, pulleys
-  - Actobotics :term:`gears <Gear>`, :term:`sprockets <Sprocket>`, pulleys
   - goBILDA :term:`gears <Gear>`, :term:`sprockets <Sprocket>`, pulleys
+  - REV :term:`gears <Gear>`, :term:`sprockets <Sprocket>`, pulleys
   - TETRIX :term:`gears <Gear>` and pulleys
   - AndyMark :term:`gears <Gear>` and pulleys
 
 - Wheels
 
-  - AndyMark traction, :term:`compliant <Compliant Wheel>`, :term:`mecanum wheel <Mecanum Wheel>`
+  - goBILDA traction, :term:`omni <Omni Wheel>`, :term:`mecanum wheel <Mecanum Wheel>`
   - REV grip, traction, :term:`omni <Omni Wheel>`, :term:`mecanum wheel <Mecanum Wheel>`
+  - AndyMark traction, :term:`compliant <Compliant Wheel>`, :term:`mecanum wheel <Mecanum Wheel>`
   - ServoCity traction, :term:`omni wheel <Omni Wheel>`
-  - goBILDA traction, :term:`omni <Omni Wheel>`, :term:`mecanum wheel <Mecanum Wheel>`
   - TETRIX traction, :term:`omni <Omni Wheel>`, :term:`mecanum wheel <Mecanum Wheel>`
   - Nexus :term:`mecanum wheel <Mecanum Wheel>`
 
 - Linear Slide Kits
 
+  - goBILDA Viper-Slide kit, Linear Actuator kit, other `goBILDA linear motion kits <https://www.gobilda.com/linear-motion-kits>`_
   - REV 15 mm :term:`extrusion <Extrusion>` slide kit
-  - Actobotics linear slide kit
-  - goBILDA linear slide kit
 
 - Drawer Slides
 

source/docs/appendix/vendor-list.rst

@@ -10,11 +10,12 @@ Vendor List
 - `AndyMark <https://andymark.com>`_
 
   - AndyMark sells the official game field and game sets, as well as individual game parts and the SoftTiles foam tiles.
-  - AndyMark also sells NeveRest and NeveRest Sport motors, TileRunner, compliant, stealth, and mecanum wheels, as well as many other items.
-  - AndyMark sells the Robits build system, which uses non-metric components similar to the Tetrix build system.
+  - AndyMark also sells NeveRest and NeveRest Sport motors, TileRunner chassis, compliant, stealth, and mecanum wheels, as well as many other items.
+  - AndyMark sells the Robits build system, which uses non-metric components similar to the Tetrix build system. This system is primarily marketed by accessibility/ease-of-use, which may be attractive for beginner teams.
 
 - `Axon Robotics <https://axon-robotics.com/>`_
-   - Vendor for highly customizable servos, with software functionality for range increases to switch between positional mode and continuous rotation mode.
+
+  - Vendor for highly powerful and configurable servos, with software functionality for range increases, switching between positional mode and continuous rotation mode, and more.
 
 - `CopperState <https://www.copperstate.com/>`_
 
@@ -30,16 +31,16 @@ Vendor List
   - Mid-range vendor for fasteners/other hardware, including tools.
 - `goBILDA <https://www.gobilda.com/>`_
 
-  - goBILDA sells its own build system, complete with Yellow Jacket motors, channel, motion components, and battery. Note that the cheapest batteries are found here, the MATRIX 12V Batteries are $39.99, with the team discount they are $29.99, nearly half the price of the $50 batteries sold elsewhere.
+  - goBILDA sells its own build system, complete with motors, channel, motion components, and battery.
   - Teams can get a 25% Team Discount from goBILDA.
 - `McMaster-Carr <https://www.mcmaster.com>`_
 
   - McMaster-Carr sells hardware and raw materials in bulk quantities. They stock nearly every type of bolt, screw, and nut possible, as well as washers, bearings, springs, etc. Purchase from them for bulk quantities of hardware, as well as the times you need a very obscure part.
   - Don't be turned off by the hidden shipping. Generally, McMaster-Carr's shipping is around the same price as other vendors, and shipping is usually next-day.
 - `MiSUMI <https://us.misumi-ec.com/>`_
 
-  - MiSUMI is a Japanese company specializing in industrial and manufacturing components. They sell bulk 15mm anodized :term:`extrusion <Extrusion>` similar to the REV Robotics :term:`extrusion <Extrusion>`. The 15mm :term:`extrusion <Extrusion>` can be cut to length as well.
-  - MiSUMI also sells aluminum drawer slides that are popular for linear extensions. They are available in different lengths, but the most common is 400mm.
+  - MiSUMI is a Japanese company specializing in industrial and manufacturing components. They sell the SAR2 and SAR3 series aluminum drawer slides that are popular for linear extensions. They are available in many different lengths, but the most common are 300mm and 400mm.
+  - MiSUMI also sells bulk 15mm anodized :term:`extrusion <Extrusion>` similar to the REV Robotics :term:`extrusion <Extrusion>`. The 15mm :term:`extrusion <Extrusion>` can be cut to length as well.
 - `OnlineMetals <https://www.onlinemetals.com/>`_
 
   - A common vendor for purchasing various raw metals.
@@ -49,19 +50,18 @@ Vendor List
 - `REV Robotics <https://www.revrobotics.com>`_
 
   - REV Robotics sells the REV build system, which is an :term:`extrusion <Extrusion>`-based ecosystem complete with motors (HD Hex, HD Planetary, Core HEX), :term:`extrusion <Extrusion>`, :term:`servos <Servo>` (Smart Robot Servo), brackets, and battery.
-  - REV also sells the control system for FTC\ |reg| (Expansion Hub and Control Hub).
+  - REV also sells the control system for FTC\ |reg| (Control Hub, Expansion Hub, Driver Hub, and optional Servo Hub).
 
     - REV offers various sensors (Magnetic Limit Switch, Color Sensor, Touch Sensor, Distance Sensor, Potentiometer, etc.)
-    - Additionally, electronic components such as the Servo Power Module, SPARKmini, or Blinkin may be purchased.
+    - Additionally, electronic components such as the SPARKmini and Blinkin may be purchased.
 - `Servocity <https://www.servocity.com>`_
 
   - Servocity sells a wide range of :term:`servos <Servo>`, from Hitec to Futaba, at all price points.
   - Teams can get a 25% team discount from Servocity
 
 - `Studica <https://www.studica.com/first-tech-challenge>`_
 
-  - Studica sells the Studica build system, which has hole patterns compatible with most systems.
-  - Additionally Studica owns and sells the navX product, a higher-end IMU than what is provided in the Control Hub.
+  - Studica sells the Studica build system, which uses M3 screws and has hole patterns compatible with many systems.
 
 - `West Coast Products <https://wcproducts.com/>`_