Skip to content

Replace game manuals 1 & 2 with the new Competition Manual #295

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 17 commits into
base: main
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
Expand Up @@ -45,11 +45,11 @@ 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
or one of the approved Android Smartphones listed in the
:doc:`Competition Manual <../../../team_resources/team_resources>`. 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>`.
defined in the Competition Manual.

USB-OTG Adapter / Hubs
----------------------
Expand Down Expand Up @@ -144,8 +144,7 @@ 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
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.

Expand Down Expand Up @@ -257,7 +256,7 @@ Gamepads

Quadstick FPS

:ref:`Game Manual 1 <manuals/game_manuals/game_manuals:game manuals>` defines
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
Expand Down
4 changes: 2 additions & 2 deletions docs/source/control_hard_compon/ds_components/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -14,8 +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
transportation. See the
:doc:`Competition Manual <../../team_resources/team_resources>` for more information
on Driver Station Carriers.

.. tab-set::
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -11,8 +11,8 @@ As the connector is known for its fragility it is highly recommended you be care
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
to connect a grounding strap. For more information on legal grounding straps see the,
:ref:`Competition Manual <team_resources/team_resources:team resources>`. For more information on this port please see
`REV Documentation <https://docs.revrobotics.com/duo-control/control-system-overview/control-hub-basics#input-power-specifications>`_.

Motor Ports
Expand Down Expand Up @@ -46,7 +46,7 @@ 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
the Competition Manual. 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
Expand All @@ -56,8 +56,8 @@ 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
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>`.
`REV +5V Power Port Documentation <https://docs.revrobotics.com/duo-control/control-system-overview/control-hub-basics#id-5v-power-port-specifications>`_ and the
Competition manual.

Analog Ports
--------------
Expand Down Expand Up @@ -88,7 +88,7 @@ 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
by the Competition Manual. 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>`_.
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -89,10 +89,10 @@ 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
Motors are the primary drivers of a robot. All motors are 12v brushed DC motors and are enumerated in the
:ref:`Competition Manual <team_resources/team_resources:team resources>`. They may only be controlled
via a REV Expansion Hub, REV Control Hub, REV SPARKmini Motor Controller, or VEX Motor
Controller 29. ``<RE09>``
Controller 29.

Additional Resources
---------------------
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -59,10 +59,10 @@ 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>`
the batteries shown above. Refer to the
:ref:`Competition Manual <team_resources/team_resources:team resources>`
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
to replace the connector on the batteries, provided the in-line
fuse on the battery is preserved.

.. warning::
Expand Down Expand Up @@ -146,9 +146,8 @@ 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>``
along with its label should be placed in accordance to the Competition manual.
The legal power switches are shown above.

:download:`Power Switch Label <https://www.firstinspires.org/sites/default/files/uploads/resource_library/ftc/power-button-labels.pdf>`

Expand Down Expand Up @@ -194,8 +193,7 @@ 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>`
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.

Expand Down Expand Up @@ -252,11 +250,7 @@ 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``).
that can be used in specific situations in accordance with the Competition Manual.
However, having a COTS USB External Battery on the Robot carries additional
considerations. All teams must ensure their COTS USB Battery Pack:

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -2,7 +2,7 @@ Sensors
=========

.. note::
As per :ref:`Game Manual Part 1<manuals/game_manuals/game_manuals:game manuals>`
As per the :ref:`Competition Manual <team_resources/team_resources:team resources>`
a UVC Webcam is not considered a sensor.

Listed below are some examples of common robot sensors. This is not
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,9 @@ Playing Field Resources

About the Playing Field
-----------------------
There are multiple configurations of the playing field that can be used. For traditional games, the playing field is a part of the ARENA that includes the 12 ft. x 12 ft. (3.66 m x 3.66 m) field and all
the elements described in the official field drawings. For remote games, the playing field is a part of the ARENA that includes the 12 ft. x 8 ft. (3.66 m x 2.44 m) field and all the elements described
in the official field drawings. The base field stays the same for all games but the game elements are subject to change as per the :ref:`Competition Manual <team_resources/team_resources:team resources>`.

There are multiple configurations of the playing field that can be used. For traditional games, the playing field is a part of the Arena that includes the 12 ft. x 12 ft. (3.66 m x 3.66 m) field and all
the elements described in the official field drawings. For remote games, the playing field is a part of the Arena that includes a 12 ft. x 8 ft. (3.66 m x 2.44 m) field and all the elements described
Expand Down
6 changes: 3 additions & 3 deletions docs/source/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -39,7 +39,7 @@ and :doc:`gracious_professionalism/gp` to see why.
game_specific_resources/blog/blog
tech_tips/tech-tips
ai/innovation_corner/innovation-corner
Competition Manual <manuals/game_manuals/game_manuals>
Team Resources <team_resources/team_resources>
Game Q&A System <game_specific_resources/ftcqa/ftcqa>
game_specific_resources/playing_field_resources/playing_field_resources
Field Coordinate System <game_specific_resources/field_coordinate_system/field-coordinate-system>
Expand Down Expand Up @@ -327,13 +327,13 @@ The main menu contains links to the top level content. The following are quick l

.. div:: col-sm pl-1 pr-1

.. button-ref:: manuals/game_manuals/game_manuals
.. button-ref:: team_resources/team_resources
:ref-type: doc
:color: black
:outline:
:expand:

Competition Manual
All Team Resources

.. div:: col-sm pl-1 pr-1

Expand Down
5 changes: 0 additions & 5 deletions docs/source/manuals/game_manuals/game_manuals.rst

This file was deleted.

4 changes: 2 additions & 2 deletions docs/source/persona_pages/rookie_teams/rookie_teams.rst
Original file line number Diff line number Diff line change
Expand Up @@ -184,13 +184,13 @@ resource you want to explore!

.. div:: col-sm pl-1 pr-1

.. button-ref:: ../../manuals/game_manuals/game_manuals
.. button-ref:: ../../team_resources/team_resources
:ref-type: doc
:color: black
:outline:
:expand:

Competition Manual
General Team Resources

.. div:: col-sm pl-1 pr-1

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -43,9 +43,7 @@ Using Kotlin in *FIRST* Tech Challenge


While there is no rule (as of the writing of this document) prohibiting Kotlin as a programming
option in *FIRST* Tech Challenge, it is not one of the recommended tools as listed in **<RS02>**
"Recommended Programming Tools" portion of the *FIRST* Tech Challenge
:doc:`Game Manual Part 1 <../../../manuals/game_manuals/game_manuals>`.
option in *FIRST* Tech Challenge, it is not one of the officially recommended or supported tools.
Teams that use Kotlin do so at their own risk and should expect that there will not be technical
help/support available at events in the case of software issues.

Expand Down
3 changes: 2 additions & 1 deletion docs/source/redirects.txt
Original file line number Diff line number Diff line change
@@ -1 +1,2 @@
ftc_docs/workflow/workflow.rst contrib/workflow/workflow.rst
"manuals/game_manuals/game_manuals.rst" "team_resources/team_resources.rst"
ftc_docs/workflow/workflow.rst contrib/workflow/workflow.rst
23 changes: 23 additions & 0 deletions docs/source/team_resources/team_resources.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
Team Resources
==============

There are several resources that teams might want to access throughout the *FIRST* Tech Challenge
season.

Pages and Links
~~~~~~~~~~~~~~~

| FTC Blog - https://community.firstinspires.org/topic/ftc
| FTC Q&A - https://ftc-qa.firstinspires.org/
| FTC Game and Season Info - https://ftc.game
| FTC Events site - https://ftc-events.firstinspires.org
| FTC Technical Support - https://ftc-community.firstinspires.org
| FTC Avatar Submission - https://ftc-scoring.firstinspires.org

Game Specific Resources
~~~~~~~~~~~~~~~~~~~~~~~

| All Resources - https://ftc.game
| FTC Competition Manual - https://ftc-resources.firstinspires.org/file/ftc/game/manual
| FTC Competition Manual (HTML) - https://ftc-resources.firstinspires.org/file/ftc/game/cm-html
| FTC Game One-Page Summary - https://ftc-resources.firstinspires.org/file/ftc/game/game-one-page