Various ftc-docs backlog of update changes (#370)

* Various ftc-docs backlog of update changes

Author: texasdiaz

docs/source/control_hard_compon/ds_components/components/components.rst

@@ -41,15 +41,13 @@ Android Device
 
       Moto E5
 
-The heart of the Driver Station is the Android Device that runs the
-Driver Station App. This Android Device requirement can be fulfilled
-either through the use of a 
-`REV Driver Hub <https://www.revrobotics.com/rev-31-1596/>`_ 
-or one of the approved Android Smartphones listed in
-:doc:`Game Manual 1 <../../../manuals/game_manuals/game_manuals>`. It is of
-vital importance that the Driver Station App be updated to a version
-that meets or exceeds the minimum Driver Station App version as
-defined in :doc:`Game Manual 1 <../../../manuals/game_manuals/game_manuals>`.
+The heart of the Driver Station is the Android Device that runs the Driver
+Station App. This Android Device requirement can be fulfilled either through
+the use of a `REV Driver Hub <https://www.revrobotics.com/rev-31-1596/>`_ or
+one of the approved Android Smartphones listed in the Competition Manual. It is
+of vital importance that the Driver Station App be updated to a version that
+meets or exceeds the minimum Driver Station App version as defined in the
+Competition Manual.
 
 USB-OTG Adapter / Hubs
 ----------------------
@@ -144,10 +142,9 @@ Comercial USB Battery Pack
       Anker Battery Pack
 
 A commercial USB battery pack is an auxiliary power source that can be used in
-specific situations in accordance with the
-:ref:`Game Manuals<manuals/game_manuals/game_manuals:game manuals>`. A USB 
-battery pack is permitted to be used to charge your Android Device. Only the
-REV Driver Hub can be charged while in use, through its USB-C port.
+specific situations in accordance with the Competition Manual. A USB battery
+pack is permitted to be used to charge your Android Device. Only the REV Driver
+Hub can be charged while in use, through its USB-C port.
 
 Gamepads
 --------
@@ -257,10 +254,10 @@ Gamepads
 
       Quadstick FPS
 
-:ref:`Game Manual 1 <manuals/game_manuals/game_manuals:game manuals>` defines
-the gamepads that are allowed in competition play. Up to two gamepads, in any
-combination, of the allowed types of gamepads may be used. All gamepads MUST be
-used in wired mode only, no wireless of any kind is allowed. Special features of
-some gamepads (Rumble, Lighting) may be programmed and used by teams for
-notifications and signaling to the drivers of the robot.
+The Competition Manual defines the gamepads that are allowed in competition
+play. Up to two gamepads, in any combination, of the allowed types of gamepads
+may be used. All gamepads MUST be used in wired mode only, no wireless of any
+kind is allowed. Special features of some gamepads (Rumble, Lighting) may be
+programmed and used by teams for notifications and signaling to the drivers of
+the robot.
 

docs/source/control_hard_compon/ds_components/index.rst

@@ -14,9 +14,8 @@ way represent the only possible way of connecting these components. These
 images also do not represent using a 
 `Driver Station Carrier <https://www.thingiverse.com/thing:3386378>`_, 
 which is recommended for teams to use for component management and
-transportation. See rule ``DS07`` in 
-:doc:`Game Manual 1 <../../manuals/game_manuals/game_manuals>` for more information 
-on Driver Station Carriers.
+transportation. See the Competition Manual for more information 
+on *OPERATOR CONSOLES*.
 
 .. tab-set::
 

docs/source/control_hard_compon/rc_components/motors/motors.rst

@@ -89,10 +89,9 @@ Motors
 
       REV Robotics Core Hex 12V DC Motor
 
-Motors are the primary drivers of a robot. All motors are 12v brushed DC motors and are enumerated in
-:ref:`Game Manual Part 1 <manuals/game_manuals/game_manuals:game manuals>`. They may only be controlled
-via a REV Expansion Hub, REV Control Hub, REV SPARKmini Motor Controller, or VEX Motor
-Controller 29. ``<RE09>``
+Motors are the primary drivers of a robot. All motors are 12v brushed DC motors
+and are enumerated in the Competition Manual. They may only be controlled via a
+REV Expansion Hub, REV Control Hub, or REV SPARKmini Motor Controller.
 
 Additional Resources
 ---------------------

docs/source/control_hard_compon/rc_components/power_distr/power-distr.rst

@@ -58,12 +58,11 @@ Robot Main Battery
 
       REV Robotics (REV-31-1302)
 
-The main power of a robot comes from one 12v battery. The battery may be one of
-the batteries shown above. Refer to section ``<RE03>`` in the 
-:ref:`Game Manual Part 1<manuals/game_manuals/game_manuals:game manuals>` 
-for exact information on allowed batteries. Note that it is typically allowed
-by ``<RE15>`` to replace the connector on the batteries, provided the in-line
-fuse on the battery is preserved.
+The main power of a robot comes from one 12v battery. The batterys above are
+samples of these batteries, check the Competition Manual for the full list of
+batteries. Note that it is typically allowed to replace the connector on the
+batteries, provided the in-line fuse on the battery is preserved, again check
+the Competition Manual for full details.
 
 .. warning:: 
    Be sure to remove the 20A fuse from the in-line fuse holder prior to cutting
@@ -145,12 +144,9 @@ Main Power Switch
 
 
 
-One Main Power Switch must control all power provided by the Main Battery. It
-along with its label should be placed in accordance to 
-:ref:`Game Manual Part 1<manuals/game_manuals/game_manuals:game manuals>`. 
-The legal power switches are shown above. ``<RE01>``
-
-:download:`Power Switch Label <https://www.firstinspires.org/sites/default/files/uploads/resource_library/ftc/power-button-labels.pdf>`
+One Main Power Switch must control all power provided by the Main Battery. The
+legal power switches above are representative examples, check the Competition
+Manual for the full list. 
 
 Power Distribution Block
 -------------------------
@@ -194,10 +190,9 @@ Power Distribution Block
       goBILDA (SKU: 3108-2833-0801)
 
 Power Distribution Blocks help to distribute the power to devices such as
-Control Hubs, SPARKminis, and more.  
-See :ref:`Game Manual Part 1<manuals/game_manuals/game_manuals:game manuals>` 
-for a description of legal Power Distribution methods. The Power
-Distribution Blocks shown are not the only legal devices for power distribution.
+Control Hubs, SPARKminis, and more.  See the Competition Manual for a
+description of legal Power Distribution methods. The Power Distribution Blocks
+shown are not the only legal devices for power distribution.
 
 REV Servo Power Module
 ----------------------
@@ -222,11 +217,13 @@ REV Servo Power Module
 
       REV (REV-11-1144)
 
-This is an electronic device that boosts the power supplied to 3-wire servos. A REV
-Servo Power Module has 6 input servo ports and 6 matching output ports. It
-draws power from a 12V source and provides 6V power to each output servo port.
-A REV Servo Power Module can provide up to 15A of current across all output
-servo ports for a total of 90 Watts of power per module.
+This is an electronic device (also known as a Servo Power Injector) that boosts
+the power supplied to 3-wire servos. A REV Servo Power Module has 6 input servo
+ports and 6 matching output ports. It draws power from a 12V source and
+provides 6V power to each output servo port.  A REV Servo Power Module can
+provide up to 15A of current across all output servo ports for a total of 90
+Watts of power per module. There are more Servo Power Injectors allowed by the
+Competition Manual.
 
 COTS USB Battery Pack
 ---------------------
@@ -252,13 +249,12 @@ COTS USB Battery Pack
       Anker Battery Pack
 
 A Commercial Off The Shelf (COTS) USB battery pack is an auxiliary power source
-that can be used in specific situations in accordance with the :ref:`Game
-Manuals<manuals/game_manuals/game_manuals:game manuals>`. In the 2023-2024
-season, these batteries were deemed permissible to power LEDs (per
-``<RE12>f.ii``) and, by extension, COTS light controller sources like the `REV
-Blinkin <https://www.revrobotics.com/rev-11-1105/>`__ (per ``<RE12>e``).
-However, having a COTS USB External Battery on the Robot carries additional
-considerations.  All teams must ensure their COTS USB Battery Pack:
+that can be used in specific situations in accordance with the Competition
+Manual. In the 2023-2024 season, these batteries were deemed permissible to
+power LEDs and, by extension, COTS light controller sources like the `REV
+Blinkin <https://www.revrobotics.com/rev-11-1105/>`__.  However, having a COTS
+USB External Battery on the Robot carries additional considerations.  All teams
+must ensure their COTS USB Battery Pack:
 
 - Is manufactured by a reputable brand.
 - Is within allowed Watt-hour capacity limits.
@@ -370,8 +366,9 @@ excessive heat, fire, or explosion and all reasonable efforts should be taken
 to prevent them.
 
 .. warning::
-   Never get a COTS USB Battery Pack wet. If it gets wet, follow the manufacturer's
-   recommended procedure to clean and dry the battery before continuing use.
+   Never get a COTS USB Battery Pack wet. If it gets wet, follow the
+   manufacturer's recommended procedure to clean and dry the battery before
+   continuing use.
 
 Charge COTS USB Battery Packs properly
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
@@ -400,27 +397,27 @@ to protect and package the battery cell(s) within. Therefore it can be
 difficult to determine if the battery is showing signs of failure and distress.
 Here are several tips for identifying a failing battery:
 
-- Check for Leaking Power Cells. Similar to an acid leak in an alkaline battery,
-  check to see if there are any signs of corrosion or acid leak from the 
-  battery pack. This might be difficult to determine, so stay vigilent. If signs
-  of acid or corrosion are present, dispose of the battery per the manufacturer's
-  recommendations immediately with extreme prejudice.
-- Look for bulging within the battery casing. When Lithium batteries fail, often 
-  they will begin to bulge like a balloon. If the case of the battery shows any
-  signs of pressure from within, dispose of the battery per the manufacturer's 
-  recommendations immediately with extreme prejudice.
+- Check for Leaking Power Cells. Similar to an acid leak in an alkaline
+  battery, check to see if there are any signs of corrosion or acid leak from
+  the battery pack. This might be difficult to determine, so stay vigilent. If
+  signs of acid or corrosion are present, dispose of the battery per the
+  manufacturer's recommendations immediately with extreme prejudice.
+- Look for bulging within the battery casing. When Lithium batteries fail,
+  often they will begin to bulge like a balloon. If the case of the battery
+  shows any signs of pressure from within, dispose of the battery per the
+  manufacturer's recommendations immediately with extreme prejudice.
 - Test the battery pack for any non-functional ports. Sometimes non-functional
-  ports can be an early sign of internal damage. DO NOT use batteries that 
-  are suspected of being damaged - dispose of the battery per the manufacturer's
+  ports can be an early sign of internal damage. DO NOT use batteries that are
+  suspected of being damaged - dispose of the battery per the manufacturer's
   recommendations immediately.
 
 Isolate COTS USB Battery Packs from the Robot Power
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-Great care must be take to NEVER allow the COTS USB Battery Pack to be connected 
-to the main (or any) power system in use by the robot. The COTS USB Battery Pack 
-and connected devices must be completely isolated from the robot electrical system, 
-with the exception of controlling signals provided by the Game Manual 
-(per rule ``<RE12>.d``). When using a COTS USB Battery Pack, controlling signals
-for LEDs powered by the Pack should ONLY connect to compatible devices listed in 
-rule ``<RE12>.e``.
+Great care must be take to NEVER allow the COTS USB Battery Pack to be
+connected to the main (or any) power system in use by the robot. The COTS USB
+Battery Pack and connected devices must be completely isolated from the robot
+electrical system, with the exception of controlling signals provided by the
+Competition Manual.  When using a COTS USB Battery Pack, controlling signals
+for LEDs powered by the Pack should ONLY connect to allowed compatible devices.
+

docs/source/control_hard_compon/rc_components/sensors/sensors.rst

@@ -1,14 +1,8 @@
 Sensors
 =========
 
-.. note:: 
-   As per :ref:`Game Manual Part 1<manuals/game_manuals/game_manuals:game manuals>` 
-   a UVC Webcam is not considered a sensor.
-
-Listed below are some examples of common robot sensors. This is not
-intended to limit or extend in any way the scope of sensors as established in
-``<RE12>``. While the *FIRST* Tech Challenge SDK supports many sensors not all
-are natively supported.
+Listed below are some examples of common robot sensors. While the *FIRST* Tech
+Challenge SDK supports many sensors not all are natively supported.
 
 Examples
 ----------

docs/source/devices/huskylens/huskylens.rst

@@ -49,9 +49,8 @@ This tutorial does **not** cover the (many) ways to:
    -  crimped connectors
    -  lever nuts (example below)
 
-FTC `Game Manual 1 <https://www.firstinspires.org/resource-library/ftc/game-and-season-info>`__
-allows this work, but teams must ensure high quality for robot competition all
-season.
+FTC Competition Manual allows this work, but teams must ensure high quality for
+robot competition all season.
 
 .. figure:: images/060-adapter.png
    :align: center
@@ -405,8 +404,7 @@ Competition Notes
 ~~~~~~~~~~~~
 
 Now you are ready to experiment with color recognition of an actual Team
-Prop, also called a Team Game Element. Study `Game Manual
-1 <https://www.firstinspires.org/resource-library/ftc/game-and-season-info>`__
+Prop, also called a Team Game Element. Study the Competition Manual
 and the `FTC Q&A <https://ftc-qa.firstinspires.org/>`__ for the Team
 Prop requirements. Choose your shades of “red” and “blue” (see note
 below), and follow the same steps as above.
@@ -418,19 +416,9 @@ The above trained **blue object** is not the same shade of blue as the
 blue Spike Mark. This difference increases the chance of a distinct and
 correct recognition of the object color.
 
-`Game Manual
-1 <https://www.firstinspires.org/resource-library/ftc/game-and-season-info>`__
-(Rule TE2) specifically allows the Team Prop to be a different shade of
-Red or Blue, compared to the official tape color of Spike Marks:
-
-   *“The Team Game Element may include multiple shades of the assigned
-   color.”*
-
-…and emphasized in the `FTC
-Q&A <https://ftc-qa.firstinspires.org/qa/15>`__:
-
-   *“Light blue and pink are acceptable colors providing it is obvious to
-   the field personnel which alliance the Team Prop belongs to.”*
+In this game, the Competition Manual specifically allowed the Team Prop to be a
+different shade of Red or Blue, compared to the official tape color of Spike
+Marks.
 
 3. Lighting
 ~~~~~~~~~~~

docs/source/ftc_sdk/overview/index.rst

@@ -137,11 +137,11 @@ no longer necessary.
 Updating SDK Software
 ---------------------
 
-It is important for teams to update the SDK software. Updates
-mid-season may not be required. Teams can check  the minimum software version
-required for a game in Game Manual 1.  It is recommended to use the REV Hardware 
-Client to update hardware, if a 64-bit Windows computer is available. If not, then alternate
-methods provided can be used to update the software.
+It is important for teams to update the SDK software. Updates mid-season may
+not be required. Teams can check  the minimum software version required for a
+game in the Competition Manual.  It is recommended to use the REV Hardware
+Client to update hardware, if a 64-bit Windows computer is available. If not,
+then alternate methods provided can be used to update the software.
 
 -  :doc:`Updating the REV Hardware Client </ftc_sdk/updating/hardware_client/Updating-REV-Hardware-Client>`
 -  :doc:`Updating the Driver Station App </ftc_sdk/updating/ds_app/Updating-the-DS-App>`

docs/source/game_specific_resources/ftcqa/ftcqa.rst

@@ -8,9 +8,7 @@ FIRST Tech Challenge Game Q&A
 The `Game Q&A <https://ftc-qa.firstinspires.org/>`_ is a forum/tool that
 provides teams an opportunity to receive clarifications from the Game Design
 Committee about the current season's challenge. Rulings on the Q&A are final
-and binding, so all teams must make sure to check back and review the Q&A
-often. Game rulings made within the Q&A system are NOT guaranteed to be
-reflected in the appropriate Game Manual.
+and binding, and will be reflected in the Competition Manual. 
 
 How to Ask Questions
 ~~~~~~~~~~~~~~~~~~~~

docs/source/hardware_and_software_configuration/configuring/configuring_dual_hubs/configuring-dual-hubs.rst

@@ -13,7 +13,7 @@ ports.
 This document describes how to connect and configure an additional Expansion
 Hub for use in the FIRST Tech Challenge. Note that the FIRST Tech Challenge
 Competition Manual limits the maximum number of Control or Expansion Hubs on
-a single robot to two. See rule R701 for the full details.
+a single robot to two. 
 
 Equipment Needed
 ~~~~~~~~~~~~~~~~
@@ -39,8 +39,7 @@ need the following items:
      - .. figure:: images/TamiyaAdapter.jpg
 
    * - FIRST-approved 12V Battery (such as Tetrix W39057). For a list of
-       FIRST-approved 12V batteries, refer to the current Competition Manual,
-       rule R601.
+       FIRST-approved 12V batteries, refer to the current Competition Manual.
      - .. figure:: images/Battery.jpg
 
    * - REV Robotics Control Hub (REV-31-1595).
@@ -142,7 +141,7 @@ using a Control Hub on their robot.
 
    * - A FIRST-approved Android smartphone with the FTC Robot Controller
        app installed. For a list of FIRST-approved Android smartphones,
-       refer to the current Competition Manual, rule R704.
+       refer to the current Competition Manual.
      - .. figure:: images/oneAndroidPhone.jpg
 
    * -  USB Type A male to type mini-B male cable.

docs/source/hardware_and_software_configuration/self_inspect/self-inspect.rst

@@ -219,7 +219,7 @@ DS Self Inspect 3, on Driver Hub paired to RC phone
 
 -  Item 4 appears only on the Driver Hub. The check-mark indicates the
    Operating System meets the minimum version requirement in the FTC
-   Game Manual.
+   Competition Manual.
 -  Note that ``Airplane Mode`` has been omitted from the DS inspection,
    only for Driver Hub. FTC rules exclude the Driver Hub and Control Hub
    from the Airplane Mode requirement.