spelling corrections, removal of old game manual references, etc.

Author: acharraggi

docs/source/control_hard_compon/rc_components/hub/ports/ch-ports.rst

@@ -26,7 +26,7 @@ USB Type-A and USB-C and USB Mini-B refer to the type of connector.
 
 - USB Type-A is a larger rectangular connector.
 - USB-C is a smaller oval connector.
-- USB Mini-B is a smaller rectagular connector with a beveled edge.
+- USB Mini-B is a smaller rectangular connector with a bevelled edge.
 
 USB 2.0
 ^^^^^^^
@@ -55,14 +55,14 @@ laptop for loading the SDK but can also be used with a UVC Camera.
 MINI USB
 ^^^^^^^^
 
-This is a female USB Mini-B port that implements USB 2.0. Iis used only to communicate directly to
+This is a female USB Mini-B port that implements USB 2.0. It is used only to communicate directly to
 the I/O system. In this case, it is only for the purpose of uploading firmware
 to the device.
 
 HDMI
 -----
 
-The Control Hub lacks a display of its own even though it is a fully-fledged
+The Control Hub lacks a display of its own even though it is an
 Android device. The Control Hub has an HDMI port that provides video output for
 the device; this HDMI port can be used to connect to an external display.
 

docs/source/control_hard_compon/rc_components/hub/ports/std-ports.rst

@@ -7,13 +7,18 @@ Battery Ports
 
 These `XT-30 <https://docs.revrobotics.com/duo-control/control-system-overview/cables-and-connectors/xt-30-power-cable>`_ 
 connectors are used to power your REV Hub as well as all the devices connected to it. 
-As the connector is known for its fragility it is highly recommended you be careful when using it.
-It is also recommended that you expand your connector prongs periodically. For more information on this 
-process please watch this `video <https://www.youtube.com/watch?v=UYXTiSeVmB0>`_. While this video features an XT60, a larger version 
-of the XT-30, and a drone the advice is much the same. This port may also be used 
-to connect a grounding strap. For more information on legal grounding straps see ``<RE15>``, 
-:ref:`Game Manual Part 1 <manuals/game_manuals/game_manuals:game manuals>`. For more information on this port please see 
+For more information on this port please see the
 `REV Documentation <https://docs.revrobotics.com/duo-control/control-system-overview/control-hub-basics#input-power-specifications>`_.
+This port may also be used to connect a grounding strap. For more information on legal grounding straps see 
+the Power Distribution section of the `Competition Manual <https://ftc-resources.firstinspires.org/file/ftc/game/manual>`_.
+
+As the XT30 connector is known for its fragility it is highly recommended you be careful when using it.
+It is also recommended that you expand your connector prongs periodically. 
+REV has a `troubleshooting article <https://docs.revrobotics.com/duo-control/troubleshooting-the-control-system/control-hub-troubleshooting#xt30-pins-are-compressed>`_ 
+specific to expanding the pins on the XT30 connector.
+For more information on this 
+process please watch this `video <https://www.youtube.com/watch?v=UYXTiSeVmB0>`_. While this video features an XT60, a larger version 
+of the XT-30, and a drone, the advice is much the same. 
 
 Motor Ports
 -------------
@@ -45,26 +50,27 @@ Servo Ports
 
 These 0.1” Header pins are used to power and control your servos. There are 6 ports on each hub and they are numbered from 0-5. 
 Be mindful of matching the polarity of the device attached to this port as it is possible to flip the connector. 
-For increasing the power supplied to these servos it is possible to use a Servo Power Module that is in compliance with 
-``<RE05>``, :ref:`Game Manual Part 1 <manuals/game_manuals/game_manuals:game manuals>`. For more information on this port 
+For increasing the power supplied to these servos it is possible to use a Servo Power Module. 
+See the Motors & Actuators section of the `Competition Manual <https://ftc-resources.firstinspires.org/file/ftc/game/manual>`_ for approved servo power devices.
+For more information on this port 
 please see `REV Servo Port Documentation <https://docs.revrobotics.com/duo-control/control-system-overview/control-hub-basics#servo-port-specifications>`_.
 
 +5V Power Ports
 ---------------
 
 These 0.1” Header pins are used to power and control various appliances. There
 are two ports on each hub. These connectors can be used for a limited range of
-applications in FIRST Tech Challenge, such as powering powered USB hubs. For more
+applications in *FIRST* Tech Challenge, such as powering powered USB hubs. For more
 information on this port please see 
 `REV +5V Power Port Documentation <https://docs.revrobotics.com/duo-control/control-system-overview/control-hub-basics#id-5v-power-port-specifications>`_ and 
-:ref:`Game Manual Part 1 <manuals/game_manuals/game_manuals:game manuals>`.
+the Power Distribution section of the `Competition Manual <https://ftc-resources.firstinspires.org/file/ftc/game/manual>`_.
 
 Analog Ports
 --------------
 
 These 4-pin `JST-PH <https://docs.revrobotics.com/duo-control/control-system-overview/cables-and-connectors/jst-ph-sensors-and-rs485>`_ 
 style connectors are used for your analog inputs. There are 2 of these ports on each hub. These ports 
-have 4 channels labeled from 0-4. This port can be used to connect to a standalone analog sensor. A common example of an 
+have 4 channels labelled from 0-4. This port can be used to connect to a standalone analog sensor. A common example of an 
 analog sensor is a `potentiometer <https://www.revrobotics.com/rev-31-1155/>`_. An analog sensor is one that outputs a range 
 of values rather than digital which alternates between one of two states. For more information on this port please see 
 `REV Analog Port Documentation <https://docs.revrobotics.com/duo-control/control-system-overview/control-hub-basics#analog-port-specifications>`_.
@@ -73,7 +79,7 @@ Digital Ports
 ---------------
 
 These 4-pin `JST-PH <https://docs.revrobotics.com/duo-control/control-system-overview/cables-and-connectors/jst-ph-sensors-and-rs485>`_ 
-style connectors are used for your digital inputs. There are 4 of these ports on each hub with a total of 8 channels labeled from `0-7`. 
+style connectors are used for your digital inputs. There are 4 of these ports on each hub with a total of 8 channels labelled from `0-7`. 
 A device attached to a digital port alternates between one of two states (e.g., on and off). One such device would be a button. It is important
 to note that each port has two channels and devices such as the `REV Touch Sensor <https://www.revrobotics.com/rev-31-1425/>`_ will only operate on one channel (N+1).
 
@@ -87,8 +93,8 @@ I2C Ports
 
 These 4-pin `JST-PH <https://docs.revrobotics.com/duo-control/control-system-overview/cables-and-connectors/jst-ph-sensors-and-rs485>`_ 
 style connectors are used for connecting I2C sensors. Each port is a single I2C bus where multiple sensors can be 
-attached. Using sensors with identical addresses on the same bus can cause problems. The range of I2C sensors that can be connected is limited 
-by :ref:`Game Manual Part 1 <manuals/game_manuals/game_manuals:game manuals>`. While it is possible to use a large range of 
+attached. Using sensors with identical addresses on the same bus can cause problems. 
+While it is possible to use a large range of 
 sensors, the vast majority of I2C sensors do not have drivers built into the SDK. It is possible to use community drivers 
 or create your own. For more information on this port please see 
 `REV I2C Port Documentation <https://docs.revrobotics.com/duo-control/control-system-overview/control-hub-basics#i2c-port-specifications>`_.
@@ -106,5 +112,5 @@ UART
 -----
 
 This connector is used only for **Developer** (non end user) debugging. Its use is not supported 
-by FIRST.
+by *FIRST*.
 

docs/source/control_hard_compon/rc_components/uvc/uvc.rst

@@ -1,56 +1,32 @@
 UVC Webcam
 ===========
 
-.. grid:: 1 2 2 2
-   :gutter: 2
-
-   .. grid-item-card::
-      :class-header: sd-bg-dark font-weight-bold sd-text-white
-      :class-body: sd-text-left body
-
-      Logitech C270
-
-      ^^^
-
-      .. figure:: images/C270.jpg
-         :align: center
-         :width: 50 %
-         :alt: C270
-        
-      +++
-
-      Logitech C270
-
-   .. grid-item-card::
-      :class-header: sd-bg-dark font-weight-bold sd-text-white
-      :class-body: sd-text-left body
-
-      Logitech C920
+A webcam is a device that provides visual images of the surrounding
+environment. For use as part of *FIRST* Tech Challenge teams must use a commercially available off-the-shelf (COTS)
+USB Video Class `(UVC) <https://www.usb.org/document-library/video-class-v15-document-set>`_ 
+compatible camera. This device can be connected directly to
+the REV Control Hub or to the Robot Control system via a USB hub.
 
-      ^^^
+.. figure:: images/C270.jpg
+   :width: 25%
+   :class: no-scaled-link
+   :alt: Example UVC camera
+   
+   Logitech C270 Webcam
 
-      .. figure:: images/C920.jpg
-         :align: center
-         :width: 50 %
-         :alt: C920
-        
-      +++
+Webcams are intended to be used in computer vision related tasks.
+Example use cases for a webcam are:
 
-      Logitech C920
-
-A webcam is a device that provides visual images of the surrounding
-environment. For use as part of *FIRST* Tech Challenge teams must use a COTS 
-`UVC <https://www.usb.org/document-library/video-class-v15-document-set>`_ 
-(USB Video Class) Compatible Camera. This device can be connected directly to
-the REV Control Hub or to the Robot Control system via a powered USB hub
-``<RE14>``. This device is intended to be used in vision related tasks. An
-example use case of a webcam is reading the state of the barcode after
-randomization, a vision task in *Freight Frenzy*, 2021-2022.
+- :doc:`detecting <../../../apriltag/understanding_apriltag_detection_values/understanding-apriltag-detection-values>` an AprilTag,
+- determining where the robot is :doc:`located <../../../apriltag/vision_portal/apriltag_localization/apriltag-localization>` on the field,
+- using OpenCV to :doc:`detect colours or shapes <../../../color_processing/index>` of game elements.
 
 Additional Resources
 --------------------
 
+- A :doc:`list of webcams <../../../apriltag/vision_portal/visionportal_webcams/visionportal-webcams>` known to be compatible with VisionPortal.
 - :ref:`Connecting UVC Camera via Powered USB Hub <hardware_and_software_configuration/configuring/configuring_uvc_camera/configuring-uvc-camera:configuring an external uvc camera and a powered usb hub>`
 - :ref:`Connecting UVC Camera directly to REV Control Hub <hardware_and_software_configuration/configuring/configuring_external_webcam/configuring-external-webcam:configuring an external webcam with a control hub>`
 - :ref:`USB Port Overview <control_hard_compon/rc_components/hub/ports/ch-ports:USB Ports>`
 - :ref:`Vision in FIRST Tech Challenge <programming_resources/index:vision programming>`
+

docs/source/hardware_and_software_configuration/configuring/configuring_external_webcam/configuring-external-webcam.rst

@@ -133,7 +133,7 @@ is activated in your Op Mode **before** the waitForStart command:
 If you do not see the Camera Stream option in your main menu on your
 DRIVER STATION, then verify that the VisionPortal is activated
 before the waitForStart command in your Op Mode. Also make sure you’ve
-given the system enough time to initialize the Vuforia software before
+given the system enough time to initialize the VisionPortal software before
 you check to see if Camera Stream is available.
 
 Scrcpy
@@ -142,7 +142,7 @@ Scrcpy
 To view the camera output from a computer while an OpMode is running, you
 can use `scrcpy <https://github.com/Genymobile/scrcpy>`__. To do this,
 you will first need to obtain an ADB connection with your Control Hub.
-This can be done by connecting a USB-A - USB-C cable to the USB-C port
+This can be done by connecting a USB-A to USB-C cable to the USB-C port
 on your Control Hub. If on Windows, you may also connect to your Control
 Hub WiFi network and open the `REV Hardware Client <https://docs.revrobotics.com/rev-hardware-client/gs/install>`__.
 Once connected, use `these instructions <https://github.com/Genymobile/scrcpy?tab=readme-ov-file#get-the-app>`__