Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
34 commits
Select commit Hold shift + click to select a range
c2f9008
Remove section with dead blogspot entry entirely
cmacfarl Dec 9, 2024
60e4e70
Remove all obsolete game manual sections and just point people at the…
cmacfarl Dec 9, 2024
7e4c0cf
Fix http 301 redirects
cmacfarl Dec 10, 2024
a3d97bf
Remove facebook reference as it requires user login, and we should no…
cmacfarl Dec 10, 2024
61e7f59
Fix http 301 redirects
cmacfarl Dec 10, 2024
d4bf30a
Microsoft product page no longer exists. Replace with review page. …
cmacfarl Dec 10, 2024
8e2f880
Fix http 301 redirects
cmacfarl Dec 10, 2024
f9d4e96
Add localhost to linkcheck_ignore list
cmacfarl Dec 10, 2024
aa0c7e0
Remove dead blogspot section entirely
cmacfarl Dec 10, 2024
92a3b87
Oops, not localhost
cmacfarl Dec 10, 2024
246f084
Not 42, 43
cmacfarl Dec 10, 2024
b4c710b
Also 192.168.49
cmacfarl Dec 10, 2024
0a93633
Remove remote field setup and point trad setup to ftc-resources
cmacfarl Dec 10, 2024
2d4287f
javadoc.io will always redirect latest to a semantic version and we a…
cmacfarl Dec 10, 2024
5184a57
Fix http 301 redirects
cmacfarl Dec 10, 2024
f25f618
Fix field resources guide
cmacfarl Dec 10, 2024
53494de
I don't know how to fix the eduspace Solidworks anchor error, so ignore.
cmacfarl Dec 10, 2024
2ce0692
www.sciencephoto.com appears to ban bots. Pick another rook image
cmacfarl Dec 10, 2024
b78ce9e
3d -> 3ds
cmacfarl Dec 10, 2024
7bfb30c
If you reference VisionPortal, point people at VisionPortal, not Apri…
cmacfarl Dec 10, 2024
9cb7544
http -> https
cmacfarl Dec 10, 2024
fc7fd0e
Dell also hates bots. Honestly, urls to product pages are immensely …
cmacfarl Dec 10, 2024
6abdd25
Fix http 301 redirects
cmacfarl Dec 10, 2024
2d19b71
Fix http 301 redirects
cmacfarl Dec 10, 2024
801c48a
regexp doesn't work so try without port
cmacfarl Dec 10, 2024
9974c7d
Fix http 301 redirects
cmacfarl Dec 10, 2024
0e6b255
Maybe logitech won't redirect?
cmacfarl Dec 10, 2024
46f3d11
Fix http 301 redirects
cmacfarl Dec 10, 2024
adf4b89
Fix http 301 redirects
cmacfarl Dec 10, 2024
0c29cfe
Use :ref: for http://ftc-docs.firstinspires.org inline urls
cmacfarl Dec 10, 2024
0bc3221
Allow ftc-docs source to canonical URI redirects
cmacfarl Dec 10, 2024
055eb84
Fix conf.py syntax error
cmacfarl Dec 10, 2024
fff6914
Use custom anchors for url references
cmacfarl Dec 11, 2024
6807fc7
Use :ref: for http://ftc-docs.firstinspires.org inline urls
cmacfarl Dec 11, 2024
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 @@ -5,7 +5,7 @@ Introduction
------------

In the 2023-2024 season, `FIRST Tech Challenge has introduced
AprilTags <https://ftc-docs.firstinspires.org/apriltag-intro>`__ into
AprilTags <https://ftc-docs.firstinspires.org/en/latest/apriltag/vision_portal/apriltag_intro/apriltag-intro.html>`__ into
the season-unique competition. AprilTags were developed by the April
Robotics Laboratory at the University of Michigan and are a visual
fiducial tagging system, built on a similar concept as QR codes, useful
Expand Down Expand Up @@ -75,7 +75,7 @@ to verify that the page printed properly.
For more in-depth information about AprilTag detection values, and
better understanding what they mean, please visit the following website:

- https://ftc-docs.firstinspires.org/apriltag-detection-values
:ref:`Understanding AprilTag Detection Values <apriltag/understanding_apriltag_detection_values/understanding-apriltag-detection-values:understanding apriltag detection values>`
- :download:`Download and print the official PDF <files/FTCAprilTagSDK82SamplesExtended.pdf>`


Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -89,7 +89,7 @@ follows:

Further discussion is provided here:

- https://ftc-docs.firstinspires.org/apriltag-detection-values
:ref:`Understanding AprilTag Detection Values <apriltag/understanding_apriltag_detection_values/understanding-apriltag-detection-values:understanding apriltag detection values>`

Advanced CPU Management
-----------------------
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -46,7 +46,7 @@ previous run’s results.
Mac OSX users may need special software for Android file transfer.

Next, read and follow the calibration instructions posted at
`ftc-docs <https://ftc-docs.firstinspires.org/camera-calibration>`__.
`ftc-docs <https://ftc-docs.firstinspires.org/en/latest/programming_resources/vision/camera_calibration/camera-calibration.html>`__.
Other calibration programs are widely available online.

Existing Warnings
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -276,7 +276,7 @@ positive rotation.

Further discussion is provided here:

- https://ftc-docs.firstinspires.org/apriltag-detection-values
:ref:`Understanding AprilTag Detection Values <apriltag/understanding_apriltag_detection_values/understanding-apriltag-detection-values:understanding apriltag detection values>`

Note: This article does not discuss the *FIRST* Tech Challenge
:ref:`Field Coordinate System <game_specific_resources/field_coordinate_system/field-coordinate-system:scope>`.
Expand Down Expand Up @@ -373,7 +373,7 @@ follows:

Again, further discussion is provided here:

- https://ftc-docs.firstinspires.org/apriltag-detection-values
:ref:`Understanding AprilTag Detection Values <apriltag/understanding_apriltag_detection_values/understanding-apriltag-detection-values:understanding apriltag detection values>`

Summary
-------
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -237,8 +237,8 @@ Reference Frames

In the above example. the yaw angle is given as (approximately) -90 degrees.
But the camera is facing in the negative X direction, thus has a heading or yaw
angle of -180 degrees in the official FTC `field coordinate system
<https://ftc-docs.firstinspires.org/en/latest/game_specific_resources/field_coordinate_system/field-coordinate-system.html>`_
angle of -180 degrees in the official FTC
:ref:`field coordinate system <first field coordinate system>`
:

.. figure:: images/50-field-axes.png
Expand All @@ -250,8 +250,7 @@ angle of -180 degrees in the official FTC `field coordinate system

This sample OpMode uses a reference frame (coordinate system) that may be
different than what you expect from other FTC navigation applications,
including `IMU or robot axes
<https://ftc-docs.firstinspires.org/en/latest/programming_resources/imu/imu.html?highlight=field%20coordinates#axes-definition>`_\
including :ref:`IMU or robot axes <imu axes def>`
, odometry device axes, and the FTC field system (shown above). These
differences typically result in basic and obvious changes in axis direction,
axis swapping, and orthogonal angles (90-degree increments).
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -102,7 +102,7 @@ Sample OpModes:

More discussion of AprilTag pose data is available here:

- https://ftc-docs.firstinspires.org/apriltag-detection-values
:ref:`Understanding AprilTag Detection Values <apriltag/understanding_apriltag_detection_values/understanding-apriltag-detection-values:understanding apriltag detection values>`

====

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -96,7 +96,7 @@ Related Info

More discussion of the AprilTag reference frame is available here:

- https://ftc-docs.firstinspires.org/apriltag-detection-values
:ref:`Understanding AprilTag Detection Values <apriltag/understanding_apriltag_detection_values/understanding-apriltag-detection-values:understanding apriltag detection values>`

This section described the SDK's default AprilTag reference frame. Teams are
welcome to make other calculations, such as the pose of the camera (or robot)
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -55,7 +55,7 @@ Logitech C310

Logitech C310 Camera

The `Logitech C310 <https://www.logitech.com/en-us/products/webcams/c310-hd-webcam.960-000585.html>`__
The `Logitech C310 <https://www.logitech.com/en-us/products/webcams/c310-hd-webcam.html>`__
is available at some online retailers.

**FTC Hot Take:**
Expand Down Expand Up @@ -123,7 +123,7 @@ Microsoft LifeCam HD-3000 v1/v2

Microsoft LifeCam HD-3000 v1/v2

The `Microsoft LifeCam HD-3000 <https://www.microsoft.com/en/accessories/products/webcams/lifecam-hd-3000>`__
The `Microsoft LifeCam HD-3000 <https://www.digitalcameraworld.com/reviews/microsoft-lifecam-hd-3000-review>`__
is available at some online retailers.

**FTC Hot Take:**
Expand Down Expand Up @@ -190,7 +190,7 @@ Arducam Global Shutter 120 FPS
Arducam GS 120 Camera

The `Arducam Global Shutter 120
FPS <https://www.arducam.com/product/arducam-120fps-global-shutter-usb-camera-board-1mp-720p-ov9281-uvc-webcam-module-with-low-distortion-m12-lens-without-microphones-for-computer-laptop-android-device-and-raspberry-pi/>`__
FPS <https://www.arducam.com/product/arducam-100fps-global-shutter-usb-camera-board-1mp-720p-ov9281-uvc-webcam-module-with-low-distortion-m12-lens-without-microphones-for-computer-laptop-android-device-and-raspberry-pi/>`__
is available at some online retailers, including
`Amazon <https://www.amazon.com/Arducam-Distortion-Microphones-Computer-Raspberry/dp/B096M5DKY6>`__.

Expand Down
2 changes: 1 addition & 1 deletion docs/source/cad_resources/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -25,7 +25,7 @@ Here are a few tools commonly used by teams:
Software for Beginners

* `Autodesk TinkerCAD <https://www.tinkercad.com/>`__ (free) (desktop)
* `FreeCAD <https://www.freecadweb.org/>`__ (free) (desktop)
* `FreeCAD <https://www.freecad.org/>`__ (free) (desktop)

Software for Intermediate Users

Expand Down
2 changes: 1 addition & 1 deletion docs/source/cad_resources/solidworks/solidworks.rst
Original file line number Diff line number Diff line change
Expand Up @@ -16,6 +16,6 @@ SOLIDWORKS® Training Videos
^^^^^^^^^^^^^^^^^^^^^^^^^^^

Learning content for both the cloud-based and desktop-based tools is managed
through the `3DS online learning portal <https://edu.3ds.com/en/learn/eduspace>`__,
through the `3DS online learning portal <https://eduspace.3ds.com/CompanionManager/public/#/>`__,
which manages access through your 3DEXPERIENCE ID.

Original file line number Diff line number Diff line change
Expand Up @@ -38,7 +38,7 @@ pattern. This includes adding the "Color Blob Locator" Processor to the
VisionPortal.

The FTC VisionPortal was introduced in 2023. More information is available
on the `ftc-docs VisionPortal Page <https://ftc-docs.firstinspires.org/apriltag-sdk>`_.
on the :ref:`ftc-docs VisionPortal Page <apriltag/vision_portal/visionportal_overview/visionportal-overview:visionportal overview>`.

Target Color Range
------------------
Expand Down
9 changes: 9 additions & 0 deletions docs/source/conf.py
Original file line number Diff line number Diff line change
Expand Up @@ -275,6 +275,10 @@
},
}

linkcheck_allowed_redirects = {
r'https://ftc-docs\.firstinspires\.org/.*': r'https://ftc-docs\.firstinspires\.org/en/latest/.*'
}

# Firstinspires redirects to login and break our link checker :)
# ftc-ml.firstinspires.org does a redirect that linkcheck hates.
# GitHub links with Javascript Anchors cannot be detected by linkcheck
Expand All @@ -287,11 +291,16 @@
r'https://wiki.dfrobot.com/.*#',
r'https://www.solidworks.com/',
r'https://sketchup.com/',
r'https://eduspace.3ds.com/',
r'https://www.dell.com/',
r'https://april.eecs.umich.edu/',
r'https://www.autodesk.com/',
r'https://knowledge.autodesk.com/',
r'https://www.3dflow.net/',
r'https://stackoverflow.com',
r'http://192.168.43.1',
r'http://192.168.49.1',
r'https://javadoc.io/doc/org.firstinspires.ftc/',
]

latex_documents = [
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -283,8 +283,8 @@ brands are reputable and which ones are not? That's not always an easy thing to
determine, however brands such as
`Anker <https://www.anker.com/collections/power-banks>`__,
`Belkin <https://www.belkin.com/products/chargers/portable-chargers-power-banks/>`__,
`Otterbox <https://www.otterbox.com/en-us/power-packs>`__, and
`BioLite <https://www.bioliteenergy.com/collections/usb-battery-banks>`__
`Otterbox <https://www.otterbox.com/en-us/portable-chargers>`__, and
`BioLite <https://www.bioliteenergy.com/collections/portable-battery-banks>`__
are among the most-used brands in the world. *FIRST* Tech Challenge recommends
choosing an internationally reputable brand, even if the brand is more
expensive than a lesser-known brand, as these batteries will be more apt to
Expand Down
Original file line number Diff line number Diff line change
@@ -1,3 +1,5 @@
.. _first field coordinate system:

*FIRST* Tech Challenge Field “Coordinate System" Definition
===========================================================

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -15,30 +15,12 @@ in the official field drawings. The base field stays the same for all games but
Traditional Field Setup Guide
------------------------------------

This document can be found here: `Traditional Field Setup Guide <https://firstinspiresst01.blob.core.windows.net/first-in-show-ftc/field-assembly-and-setup-guide.pdf>`__
This document can be found here: `Traditional Field Setup Guide <https://ftc-resources.firstinspires.org/file/ftc/game/fieldguide>`__

.. only:: html

.. raw:: html

<iframe id="iframepdf" src="https://firstinspiresst01.blob.core.windows.net/first-in-show-ftc/field-assembly-and-setup-guide.pdf" width="100%" height="700"></iframe>

|

Remote Field Setup Guide
------------------------------------

- No Remote Field Setup Guide released yet.

.. comment

.. only:: latex

`Remote Field Setup Guide <https://firstinspiresst01.blob.core.windows.net/first-energize-ftc/remote-field-requirements.pdf>`__

.. raw:: html

<iframe id="iframepdf" src="https://firstinspiresst01.blob.core.windows.net/first-energize-ftc/remote-field-requirements.pdf" width="100%" height="700"></iframe>

|
<iframe id="iframepdf" src="https://ftc-resources.firstinspires.org/file/ftc/game/fieldguide" width="100%" height="700"></iframe>

|
Original file line number Diff line number Diff line change
Expand Up @@ -24,7 +24,7 @@ with SDK software:
- `Logitech C270 HD
Webcam <https://www.logitech.com/en-us/products/webcams/c270-hd-webcam.960-000694.html>`__
- `Logitech C310 HD
Webcam <https://www.logitech.com/en-us/products/webcams/c310-hd-webcam.960-000585.html>`__
Webcam <https://www.logitech.com/en-us/products/webcams/c310-hd-webcam.html>`__
- `Logitech C920 HD
Webcam <https://www.logitech.com/en-us/products/webcams/c920s-pro-hd-webcam.960-001257.html>`__

Expand Down
58 changes: 1 addition & 57 deletions docs/source/manuals/game_manuals/game_manuals.rst
Original file line number Diff line number Diff line change
@@ -1,61 +1,5 @@
Game Manuals
============

Game Manuals can be found on the `Game and Season Materials page <https://www.firstinspires.org/resource-library/ftc/game-and-season-info>`__ on the *FIRST* Website. They are presented here for your convenience.

.. only:: html

.. tip:: To search all four PDFs at once, just perform a search within this webpage for the content you are looking for. Then simply scroll down to each PDF to see which PDFs contained the content you were looking for!

Game Manual Part 1 Traditional Events
-------------------------------------

`Game Manual Part 1 Traditional Events <https://firstinspiresst01.blob.core.windows.net/first-in-show-ftc/game-manual-part-1-traditional.pdf>`__

.. only:: html

.. raw:: html

<iframe id="iframepdf" src="https://firstinspiresst01.blob.core.windows.net/first-in-show-ftc/game-manual-part-1-traditional.pdf" width="100%" height="700"></iframe>

|
Game Manual Part 2 Traditional Events
-------------------------------------

`Game Manual Part 2 Traditional Events <https://firstinspiresst01.blob.core.windows.net/first-in-show-ftc/game-manual-part-2-traditional.pdf>`__

.. only:: html

.. raw:: html

<iframe id="iframepdf" src="https://firstinspiresst01.blob.core.windows.net/first-in-show-ftc/game-manual-part-2-traditional.pdf" width="100%" height="700"></iframe>

|
Game Manual Part 1 Remote Events
--------------------------------

`Game Manual Part 1 Remote Events <https://firstinspiresst01.blob.core.windows.net/first-in-show-ftc/game-manual-part-1-remote.pdf>`__

.. only:: html

.. raw:: html

<iframe id="iframepdf" src="https://firstinspiresst01.blob.core.windows.net/first-in-show-ftc/game-manual-part-1-remote.pdf" width="100%" height="700"></iframe>

|
Game Manual Part 2 Remote Events
--------------------------------

`Game Manual Part 2 Remote Events <https://firstinspiresst01.blob.core.windows.net/first-in-show-ftc/game-manual-part-2-remote.pdf>`__

.. only:: html

.. raw:: html

<iframe id="iframepdf" src="https://firstinspiresst01.blob.core.windows.net/first-in-show-ftc/game-manual-part-2-remote.pdf" width="100%" height="700"></iframe>

|
Game Manuals can be found on the `Game and Season Materials page <https://ftc-resources.firstinspires.org/files/ftc/game>`__ on the *FIRST* Website. They are presented here for your convenience.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We should remove the "They are presented here for your convenience." sentence.


Original file line number Diff line number Diff line change
Expand Up @@ -59,7 +59,7 @@ want to avoid support material by designing around it. But if not possible, it's
control what areas you know need support. This makes cleanup after a print a lot easier.

If you want more info on supports, check out Prusa's guide `here!
<https://help.prusa3d.com/en/article/support-material_1698>`_
<https://help.prusa3d.com/article/support-material_1698>`_

.. image:: images/prusa3dsupports.png
:align: center
Expand Down
12 changes: 0 additions & 12 deletions docs/source/persona_pages/mentor_tech/mentor_tech.rst
Original file line number Diff line number Diff line change
Expand Up @@ -45,18 +45,6 @@ Just click on the panel for the resource you want to explore!
:class-header: sd-bg-primary font-weight-bold sd-text-white
:class-body: sd-text-left

Programming Resources

^^^

Look for Programming Resources for your team!

.. grid-item-card::
:link: http://firsttechchallenge.blogspot.com/2020/12/tips-for-your-teams-engineering.html
:link-type: url
:class-header: sd-bg-primary font-weight-bold sd-text-white
:class-body: sd-text-left

Technical Writing Resources

^^^
Expand Down
2 changes: 1 addition & 1 deletion docs/source/persona_pages/rookie_teams/rookie_teams.rst
Original file line number Diff line number Diff line change
Expand Up @@ -65,7 +65,7 @@ resource you want to explore!

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

.. button-link:: https://docs.revrobotics.com/kickoff-concepts/
.. button-link:: https://docs.revrobotics.com/ftc-kickoff-concepts/
:color: black
:outline:
:expand:
Expand Down
14 changes: 1 addition & 13 deletions docs/source/persona_pages/veteran_teams/veteran_teams.rst
Original file line number Diff line number Diff line change
Expand Up @@ -65,7 +65,7 @@ resource you want to explore!
TensorFlow in CENTERSTAGE

.. grid-item-card::
:link: https://www.firstinspires.org/resource-library/ftc/team-outreach-and-marketing-resources
:link: https://www.firstinspires.org/resource-library/ftc/team-management-resources
:link-type: url
:class-header: sd-bg-primary font-weight-bold sd-text-white
:class-body: sd-text-left body
Expand All @@ -76,18 +76,6 @@ resource you want to explore!

Links to marketing, community and industry outreach.

.. grid-item-card::
:link: http://firsttechchallenge.blogspot.com/2020/12/tips-for-your-teams-engineering.html
:link-type: url
:class-header: sd-bg-primary font-weight-bold sd-text-white
:class-body: sd-text-left

Engineering Notebook

^^^

Examples and criteria for the engineering notebook and portfolio

.. grid-item-card::
:link: https://www.firstinspires.org/sites/default/files/uploads/resource_library/ftc/award-descriptions.pdf
:link-type: url
Expand Down
6 changes: 4 additions & 2 deletions docs/source/programming_resources/imu/imu.rst
Original file line number Diff line number Diff line change
Expand Up @@ -159,6 +159,8 @@ re-open that OpMode to capture this updated configuration. Blocks are provided
only for devices in the configuration that’s active*\ **upon opening**\ *an
OpMode.*

.. _imu axes def:

Axes Definition
---------------

Expand Down Expand Up @@ -193,8 +195,8 @@ pointing along the positive axis, the fingers curl in the direction of
*Fun fact: the IMU is located approximately under the word “PROUD”, near the
lower right corner of the Hub.*

This tutorial will **not** discuss the *FIRST* Tech Challenge `Field Coordinate System
<https://ftc-docs.firstinspires.org/en/latest/game_specific_resources/field_coordinate_system/field-coordinate-system.html>`__.
This tutorial will **not** discuss the *FIRST* Tech Challenge
:ref:`Field Coordinate System <first field coordinate system>`.
Your OpModes might relate robot orientation to the overall field or `‘global
coordinates’
<https://github.com/FIRST-Tech-Challenge/FtcRobotController/wiki/Vuforia-for-Blocks#vuforia-introduction>`__
Expand Down
Loading
Loading