Merge branch 'main' into fix_more_links

Author: texasdiaz

docs/source/contrib/tutorials/setup/setup.rst

@@ -24,15 +24,15 @@ Steps
    .. tab-item:: Windows
 
       1. Install `Chocolatey <https://docs.chocolatey.org/en-us/choco/setup>`_.
-      2. Install Python 3.9 or later from the `Python website <https://www.python.org/downloads/>`_. **Make sure to check the box that says "Add Python to PATH".**
+      2. Install Python 3.9-3.12 from the `Python website <https://www.python.org/downloads/windows/>`_. **Make sure to check the box that says "Add Python to PATH".**
       3. Install Pip. ``python -m ensurepip``
       4. Install Git. ``choco install git``
       5. Install Make. ``choco install make``
       6. Install the lastest version of VS Code. ``choco install vscode``
 
    .. tab-item:: Linux/Mac
 
-      1. Install Python 3.9 or later. You can download it from the `Python website <https://www.python.org/downloads/>`_.
+      1. Install Python 3.9-3.12. You can download it from the Python website: `macOS <https://www.python.org/downloads/macos/>`_, `Linux <https://www.python.org/downloads/source/>`_.
       2. Install the latest version of `Pip <https://pip.pypa.io/en/stable/installation/>`_.
       3. Install Git from the `Git website <https://git-scm.com/downloads>`_.
       4. Install `Make <https://www.gnu.org/software/make/>`_ .

docs/source/hardware_and_software_configuration/configuring/managing_esd/files/analysis-esd-mitigation-echin.pdf

@@ -15,7 +15,7 @@ to view an in-depth white paper, written by Mr. Eric Chin (a *FIRST*
 alumnus and a 2018 summer engineering intern), which examines and
 quantifies the efficacy of various ESD mitigation techniques:
 
-`ESD Mitigation Techniques For FTC (PDF 1.7MB) <https://www.firstinspires.org/sites/default/files/uploads/resource_library/ftc/analysis-esd-mitigation-echin.pdf>`__
+* :download:`ESD Mitigation Techniques For FTC (PDF 1.7MB) <files/analysis-esd-mitigation-echin.pdf>`
 
 Special thanks to Doug Chin, Eric Chin, and Greg Szczeszynski for the work they
 did to model the problems caused by ESD and to evaluate different techniques to

docs/source/hardware_and_software_configuration/configuring/managing_esd/managing-esd.rst

@@ -49,7 +49,7 @@ and install Android Studio:
 
 *  https://developer.android.com/studio
 
-Click on the green "DOWNLOAD ANDROID STUDIO" button to start the
+Click on the white "Download Android Studio <latest version>" button to start the
 download process.
 
 .. image:: images/DownloadAndroidStudio.jpg
@@ -58,9 +58,9 @@ download process.
 
 |
 
-Accept the license terms and then push the blue "DOWNLOAD ANDROID
-STUDIO" button on the Android Developer webpage to download the
-software.
+Accept the license terms and then push the white "Download Android
+Studio <latest version> for <operating system>" button on the Android
+Developer webpage to download the software.
 
 Once the setup package has downloaded, launch the application and follow
 the on-screen instructions to install Android Studio.
@@ -70,81 +70,3 @@ the on-screen instructions to install Android Studio.
    :alt: Android Studio Setup screen
 
 |
-
-Configuring Android Studio (Ladybug and later)
-~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
-
-.. note:: 
-   
-   See the Caution above for why this is necessary.
-
-.. note:: 
-   
-   Android Studio Ladybug updates the underlying JetBrains IntelliJ version such that 
-   the interface is a VSCode look alike.  The screenshots in this documentation use the
-   JetBrains/Android Studio Classic UI which is no longer supported natively by JetBrains.
-   To follow along, users should install the `Classic UI <https://plugins.jetbrains.com/plugin/24468-classic-ui>`__ plugin.
-
-
-#. `Install JDK 17 <https://www.oracle.com/java/technologies/javase/jdk17-archive-downloads.html>`__
-   If you did not already have this installed independently of Android Studio. 
-   e.g. If you were using Android Studio’s bundled JDK, then when Ladybug is installed Android Studio 
-   will unhelpfully overwrite your old bundled JDK version. Note there’s a bug in the Settings -> Build Tools -> Gradle dialog 
-   that may make you think your old version of the JDK is there, but it is not. You must use an unbundled version of the JDK.
-
-#. Go to File -> Settings and under Build, Execution, Deployment -> Build Tools -> Gradle use the Add JDK from disk option 
-   to select the newly installed JDK 17. In the image below take careful note of the directory paths 
-   for the options labeled jbr-17 and jbr-21. Note that they are the same. This is the aforementioned UI bug, 
-   and that is Android Studio overwriting your old JDK. In this image you’ll see I’ve selected the JDK that 
-   was installed independently.
-
-.. image:: images/AndroidStudioSelectJdk.png
-   :align: center
-   :alt: Gradle setting screenshot
-
-|
-
-Do Not Upgrade Gradle
-~~~~~~~~~~~~~~~~~~~~~
-
-If you have upgraded Android Studio from an earlier version to Ladybug, or you did not install and
-configure the JDK prior to loading a FtcRobotController workspace, then Android Studio may present an 
-error and recommend that you upgrade Gradle.
-
-.. image:: images/AndroidStudioUpgradeGradle.png
-   :align: center
-   :alt: Screenshot showing Gradle upgrade messages.
-
-|
-
-Do not upgrade Gradle.  The FtcRobotController build is incompatible with upgraded Gradle.  If you do, you
-will presented with another, even more, indecipherable error.
-
-To recover, you need to rollback the changes that Android Studio made upon that click.
-To do that select Git -> Uncommitted Changes -> Show Shelf
-
-.. image:: images/AndroidStudioRecoverUpgrade.png
-   :align: center
-   :alt: Screenshot showing the Show Shelf messages.
-
-|
-
-That will show the changes you have in your workspace. You want to rollback the 4 Gradle files shown in the 
-following image. You can either select the Changes checkbox to select all files, or individually select the 
-Gradle files. Note that if you have changes in your workspace that haven’t been committed, you want to be 
-careful not to select those files or you may lose work.
-
-.. image:: images/AndroidStudioRollback.png
-   :align: center
-   :alt: Screenshot showing the four files to be rolled back.
-
-|
-
-Once you have the proper files selected, click the Rollback button.
-
-Resync and that should revert you to the error that prompted you to upgrade Gradle in the first place. 
-From there follow the instructions above to install JDK 17.
-
-
-
-

docs/source/programming_resources/tutorial_specific/android_studio/installing_android_studio/Installing-Android-Studio.rst

@@ -9,10 +9,21 @@ there is more content than is reasonable in the email blast so partial content
 is included in the blast with the rest of the content here. Blasts are ordered
 on this page chronologically, with the newest content at the top of the page.
 
-Just click to expand the Tech Tip you'd like to read.
+Just click on the tech tip to read (in the "Updated Tech Tips" list below), or 
+expand the Tech Tip (in the "Legacy Tech Tips" list) you'd like to read.
+
+Updated Tech Tips:
+------------------
+
+.. toctree::
+   :maxdepth: 1
+
+   tech-tips/tech-tip-practice-timer/tech-tip-practice-timer
+
+Legacy Tech Tips:
+-----------------
 
 .. dropdown:: Week of 11/06/2024 "Android Studio 2024.2.1 LadyBug Update and the FTC SDK"
-   :open:
 
    .. _ladybug1011:
 

docs/source/programming_resources/tutorial_specific/android_studio/installing_android_studio/images/DownloadAndroidStudio.jpg

@@ -0,0 +1,76 @@
+FTC Driver Station Practice Timer
+=================================
+
+Started in the 2023-2024 season, Tech Tips are segments released in the
+*FIRST* Tech Challenge `Team E-mail Blast
+<https://www.firstinspires.org/resource-library/ftc/team-blast-archive>`__.
+Sometimes the Tech Tips are included in whole in the email blast, but sometimes
+there is more content than is reasonable in the email blast so partial content
+is included in the blast with the rest of the content here. 
+
+.. _practicetimer:
+
+**FTC Driver Station Practice Timer**
+
+Did you know there's a powerful tool lurking within your FTC Driver Station App, 
+designed to help your team dominate match timing? Forget the need for complex 
+event software – your Driver Station has a built-in Practice Match timer that 
+simulates the entire match flow, or any part of it! 
+Imagine perfecting your autonomous routine, nailing the Auto-TeleOp transition, 
+or optimizing your endgame strategy, all without the pressure of a real 
+competition. This (not so) hidden gem allows teams to practice match timing for 
+every critical phase: 
+
+* Autonomous - Fine-tune your robot's pre-programmed actions. 
+* Auto-TeleOp Transition - Seamlessly swap control from autonomous to TeleOp. 
+* TeleOp - Maximize your scoring potential during the main TeleOp period. 
+* Endgame - Strategize and execute your final, high-scoring moves. 
+
+This feature is a game-changer for practice sessions, allowing your team to build 
+muscle memory and confidence in a realistic, simulated environment. 
+Ready to unlock your team's full potential?
+
+*How does it work?* In the upper-left corner of the Driver Station App you will
+see the "Practice Timer Window". This has the heading "Practice Timer" and has
+the remaining time (in a possible practice match) as well as a "PLAY" button.
+This Practice Timer area is always visible regardless of what OpModes are
+running or any other activities (on the same screen). This Practice Timer also
+runs independently of other activities, therefore OpModes can be selected,
+started, stopped, reselected, and so on while the Practice Timer is running
+without affecting the timer.
+
+.. figure:: images/practice-timer.png
+   :align: center
+   :width: 75%
+   :alt: Image showing Practice Timer Window
+
+   Practice Timer Window
+
+.. tip::
+   The Practice Timer uses audio for cues, be sure the audio is enabled and
+   at sufficient volume to hear the cues for match transitions.
+
+Press the tiny "Play" button in the Practice Timer window, and the software
+will prompt where in the match to start the timer at. Options are:
+
+* Autonomous
+* Auto -> TeleOp Transition
+* TeleOp
+* Endgame (30s endgame, not updated for DECODE)
+
+.. note::
+   The *Autonomous* and *Transition* periods have audio cues that give the user
+   time to select and start OpModes in sync with the match transition, whereas 
+   the other options start as soon as the option is selected.
+
+.. figure:: images/practice-timer-selection.png
+   :align: center
+   :width: 75%
+   :alt: Image of Driver Station match period selection screen
+
+   Selecting the Practice Match starting Match Period
+
+Got any questions about how to take advantage of the Practice Timer and other
+features of the FTC Driver Station App? Come start or join the conversation 
+on the `FTC Community Forums <https://ftc-community.firstinspires.org/>`__!
+