Merge branch 'main' into android

Author: miriamsr

.github/workflows/link-check.yaml

@@ -26,7 +26,7 @@ jobs:
 
       - name: Arhive Log
         if: ${{ failure() }}
-        uses: actions/upload-artifact@v2
+        uses: actions/upload-artifact@v4
         with:
           name: LINKCHECK--1
           path: docs/build/linkcheck/output.txt

.github/workflows/pull-request.yaml

@@ -34,7 +34,7 @@ jobs:
         env:
           PR_NUMBER: ${{ github.event.number }}
           ID:  ${{ github.run_attempt }}
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
           name: FTCDOCS-PDF
           path: |
@@ -66,7 +66,7 @@ jobs:
         run: make -C docs/ html
 
       - name: Archive Site
-        uses: actions/upload-artifact@v3
+        uses: actions/upload-artifact@v4
         with:
           name: FTCDOCS-HTML
           path: 'docs/build/html'
@@ -169,7 +169,7 @@ jobs:
 
       - name: Archive Log
         if: always()
-        uses: actions/upload-artifact@v2
+        uses: actions/upload-artifact@v4
         with:
           name: LINKCHECK-PR-${{ github.event.number }}-${{ github.run_attempt }}
           path: docs/build/linkcheck/output.txt

docs/source/programming_resources/shared/configuring_android/Configuring-Your-Android-Devices.rst

@@ -55,7 +55,7 @@ smartphone for use as an DRIVER STATION. The process is as follows,
 Renaming Your Smartphones
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
-The official rules of the FIRST Tech Challenge (see <RS01>) require that
+The official rules of the *FIRST* Tech Challenge (see <RS01>) require that
 you change the Wi-Fi name of your smartphones to include your team
 number and "-RC" if the phone is a Robot Controller or "-DS" if it is a DRIVER STATION. A team can insert an additional dash and a letter ("A",
 "B", "C", etc.) if the team has more than one set of Android phones.
@@ -120,7 +120,7 @@ level, as described below.
    * - 7. Select **Configure Device** from the pop-up menu.
      - |rename7|
 
-   * - 8. Use touch pad to enter new name of device. If the device will be a Robot Controller, specify your team number and -RC. If the device will be a DRIVER STATION, specify your team number and -DS. You can also set the Wi-Fi Direct inactivity timeout to *Never disconnect* and then hit the\ **SAVE** button to save your changes. Note that in the screenshot shown to the right, the team number is 9999. The "-C" indicates that this is from the third pair of smartphones for this team. The -RC indicates that this phone will be a Robot Controller.
+   * - 8. Use touch pad to enter new name of device. If the device will be a Robot Controller, specify your team number and -RC. If the device will be a DRIVER STATION, specify your team number and -DS. You can also set the Wi-Fi Direct inactivity timeout to *Never disconnect* and then hit the\  **SAVE** button to save your changes. Note that in the screenshot shown to the right, the team number is 9999. The "-C" indicates that this is from the third pair of smartphones for this team. The -RC indicates that this phone will be a Robot Controller.
      - |rename8|
 
    * - 9. After renaming phone, power cycle thedevice.
@@ -194,7 +194,7 @@ follows:
    * - Step
      - Image
 
-   * - 1. Go to "Settings", then tap "About device"or "About phone".
+   * - 1. Go to "Settings", then tap "About device" or "About phone".
      - |devop1|
 
    * - 2. Scroll down, then tap Build number seven times. Depending on your device and operating system, you may need to tap Software information, then tap Build number seven times.
@@ -213,7 +213,7 @@ follows:
 Placing Phones into Airplane Mode with Wi-Fi On
 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
-For the FIRST Tech Challenge competitions, it is important that you
+For the *FIRST* Tech Challenge competitions, it is important that you
 place your Robot Controller and DRIVER STATION devices into Airplane mode
 but keep their Wi-Fi radios turned on. This is important because you do
 not want any of the cellular telephone functions to be enabled during a
@@ -415,4 +415,4 @@ Note that it will take an estimated 10 minutes to complete this task.
      - |pairingns11|
 
    * - 12. Verify that the Robot Controller screen has changed and that it now indicates that it is connected to the DRIVER STATION.The Network status should read active, connected on the Robot Controller's main screen.
-     - |pairingns12|
+     - |pairingns12|

docs/source/programming_resources/shared/control_system_intro/The-FTC-Control-System.rst

@@ -42,7 +42,7 @@ During a competition, each team has two Android devices.
 One Android device is mounted onto the robot and is called the *Robot
 Controller*. The Robot Controller acts as the “brains” of the robot. It
 does all of the thinking for the robot and tells the robot what to do.
-It consists of an Android device running an Robot Controller app.
+It consists of an Android device running a Robot Controller app.
 There are two hardware options currently being used: REV Robotics
 Expansion Hub or the REV Robotics Control Hub.
 
@@ -102,7 +102,7 @@ Controller and the I/O module.
 What’s an Op Mode?
 ~~~~~~~~~~~~~~~~~~
 
-During a typical FIRST Tech Challenge match, a team’s robot has to
+During a typical *FIRST* Tech Challenge match, a team’s robot has to
 perform a variety of tasks in an effort to score points. For example, a
 team might want their robot to follow a white line on the competition
 floor and then score a game element (such as a ball) into a goal

docs/source/tech_tips/tech-tips.rst

@@ -11,9 +11,47 @@ 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.
 
-.. dropdown:: Week of 08/19/2024 "REV Driver Hub Batteries"
+.. dropdown:: Week of 09/09/2024 "AI Innovation Corner - Google AI Studio"
    :open:
 
+   .. _googleAIstudio:
+
+   **AI Innovation Corner - Google AI Studio**
+
+   This week’s Tech Tip of the Week launches a new initiative in *FIRST* Tech 
+   Challenge, an AI Innovation Corner. Generative AI has taken the world by 
+   storm, becoming commonplace now in everything from personal assistants, 
+   search engines, recipe curation, music innovation, and vehicle maintenance! 
+   Machine Learning AI has been a part of *FIRST* Tech Challenge in some way for 
+   the past six years, and we’re now transitioning to help teams learn how to 
+   use and incorporate Generative AI in their *FIRST* Tech Challenge experience 
+   (while we’re learning ourselves!).
+
+   The first step (or *FIRST* step?) to getting the most out of AI is choosing a 
+   model. What do I mean by model? Every AI is a neural network that has been 
+   trained with specific knowledge with the ability to do specific things based 
+   on that knowledge. Each version of this neural network is stored in a “model”. 
+   Each different company has different models available for different purposes, 
+   though most models are variations on their flagship model (Gemini from Google, 
+   ChatGPT 4-o from OpenAI, Claude from Anthropic, and so on). Each company has 
+   different web-based and API interfaces for interacting with their models, and 
+   everyone has their favorite. In *FIRST* Tech Challenge, the standard tool we use 
+   is `Google AI Studio <https://ai.google.dev/aistudio>`__ to interact with Gemini. 
+
+   Google AI Studio is free to use, but requires a Google account to access - 
+   virtually all models require a login or API token of some kind to use. Google 
+   AI Studio is our favorite for its list of examples (Prompt Gallery) and its 
+   easy to use interface to save prompt sessions and resume them later. With 
+   Google AI Studio, you also can select the specific model you want to use, and 
+   when available you can choose to use preview versions of up and coming models. 
+
+   Future AI articles will be released not under the “Tech Tip of the Week” headline 
+   but under the “AI Innovation Corner” headline. Keep an eye out for future AI tips 
+   via the Team Blast and `ftc-docs <https://ftc-docs.firstinspires.org/en/latest/>`__ 
+   website!
+
+.. dropdown:: Week of 08/19/2024 "REV Driver Hub Batteries"
+
    .. _driverhubbatteries:
 
    **REV Driver Hub Batteries**
@@ -550,7 +588,7 @@ Just click to expand the Tech Tip you'd like to read.
       * - `Studica Multi-Mode Smart Servo <https://www.studica.com/studica-robotics-brand/multi-mode-smart-servo>`__
         - 62 RPM
         - 20 kg-cm
-        - ??
+        - 1.8 A
         - 3.18 W
         - $23.99
       * - `AndyMark am-4955 High Speed Servos <https://www.andymark.com/products/programmable-servos>`__