Merge branch 'main' into fix-index

acharraggi · web-flow · commit 10d319d6e559 · 2025-01-29T08:28:46.000-08:00
diff --git a/docs/source/apriltag/vision_portal/visionportal_webcams/visionportal-webcams.rst b/docs/source/apriltag/vision_portal/visionportal_webcams/visionportal-webcams.rst
@@ -148,9 +148,8 @@ calibration values** for the FTC VisionPortal default resolution of
 Other Webcams
 -------------
 
-Many other webcams are available online, with and without published `UVC
-compatibility <https://en.wikipedia.org/wiki/List_of_USB_video_class_devices>`__.
-The FTC SDK supports **only** UVC compatible webcams. Many modern
+Many other webcams are available online, with and without published UVC
+compatibility.  The FTC SDK supports **only** UVC compatible webcams. Many modern
 webcams are UVC compatible without specifically advertising it; often
 indicated by “no drivers needed”.
 
diff --git a/docs/source/booklets/advanced.rst b/docs/source/booklets/advanced.rst
@@ -1,5 +1,8 @@
 :orphan:
 
+.. meta::
+   :robots: noindex, nofollow
+
 .. only:: latex
 
     Advanced Topics, Progrmming Resources
@@ -27,4 +30,4 @@
         /programming_resources/shared/myblocks/index
         /programming_resources/shared/external_libraries_blocks/external-libraries-blocks.rst
         /programming_resources/imu/imu.rst
-        /programming_resources/shared/installing_kotlin/Installing-Kotlin
+        /programming_resources/shared/installing_kotlin/Installing-Kotlin
diff --git a/docs/source/booklets/apriltags.rst b/docs/source/booklets/apriltags.rst
@@ -1,5 +1,8 @@
 :orphan:
 
+.. meta::
+   :robots: noindex, nofollow
+
 .. only:: latex
 
     April Tags in *FIRST* Tech Challenge
diff --git a/docs/source/booklets/control_system.rst b/docs/source/booklets/control_system.rst
@@ -1,5 +1,8 @@
 :orphan:
 
+.. meta::
+   :robots: noindex, nofollow
+
 .. only:: latex
 
     *FIRST* Tech Challenge Control System
diff --git a/docs/source/booklets/sdk.rst b/docs/source/booklets/sdk.rst
@@ -1,5 +1,8 @@
 :orphan:
 
+.. meta::
+   :robots: noindex, nofollow
+
 .. only:: latex
 
     *FIRST* Tech Challenge SDK
diff --git a/docs/source/programming_resources/shared/choosing_program_lang/choosing-program-lang.rst b/docs/source/programming_resources/shared/choosing_program_lang/choosing-program-lang.rst
@@ -1,36 +1,51 @@
 Choosing a Programming Tool
 ============================
-You will need to select a programming tool to be able to write op modes
-for your competition robot. FIRST strongly recommends that *all users*
+
+You need to select a programming tool to be able to create op modes
+for your competition robot. 
+An Op Mode or Operational Mode is program that tells the robot what to do.
+There are three programming tools that are available for you to use.
+
+*FIRST* strongly recommends that **all users**
 begin by learning how to use the :ref:`Blocks programming
 tool <programming_resources/blocks/blocks-tutorial:blocks programming tutorial>`.
 
-There are currently three programming tools that are available for the
-teams to use:
+The Blocks Programming Tool
+---------------------------
 
-1. **The Blocks Programming Tool** - A visual, programming tool that
-   lets programmers use a web browser to create, edit and save their op
-   modes. This tool is recommended for novice programmers and for users
-   who prefer to design their op modes visually, using a drag-and-drop
-   interface.
+A visual programming tool that
+lets programmers use a web browser to create, edit and save their op
+modes. This tool is recommended for novice programmers and for users
+who prefer to design their op modes visually, using a drag-and-drop
+interface.
 
 .. image:: images/BlocksPicture1.jpg
+   :alt: Blocks Programming Tool showing a graphical Blocks program.
 
-2. **The OnBot Java Programming Tool** - A text-based programming
-   tool that lets programmers use a web browser to create, edit and save
-   their Java op modes. This tool is recommended for programmers who
-   have basic to advanced Java skills and who would like to write
-   text-based op modes.
+The OnBot Java Programming Tool
+-------------------------------
+A text-based programming
+tool that lets programmers use a web browser to create, edit and save
+their Java op modes. This tool is recommended for programmers who
+have basic to advanced Java skills and who would like to write
+text-based op modes.
 
 .. image:: images/onBotJavaScreen.jpg
+   :alt: OnBot Java Programming Tool showing Java source code.
 
-3. **Android Studio** - An advanced integrated development environment
-   for creating Android apps. This tool is the same tool that
-   professional Android app developers use. Android Studio is only
-   recommended for advanced users who have extensive Java programming
-   experience.
+Android Studio
+--------------
+An advanced integrated development environment
+for creating Android apps. This tool is the same tool that
+professional Android app developers use. Android Studio is only
+recommended for advanced users who have extensive Java programming
+experience.
 
 .. image:: images/androidStudioScreen.jpg
+   :alt: Android Studio showing Java source code.
+
+Recommendations
+---------------
 
 Each tool has its own merits and weaknesses. For many users (especially
 rookies and novice programmers), **the Blocks Programming Tool is
@@ -43,6 +58,7 @@ Tool. However, OnBot Java is a text-based tool and it requires that the
 user have a sound understanding of the Java programming language.
 
 .. image:: images/ipadPhoneChromebook.jpg
+   :alt: A tablet, a phone, and a laptop each showing the programming tools in use.
 
 It is important to note that with the Blocks Programming Tool and the
 OnBot Java Programming Tool, a user only needs a web browser to create,
@@ -53,6 +69,7 @@ Android Studio is a powerful development tool. However, it requires
 extensive Java programming knowledge. It also needs a dedicated laptop
 to run the Android Studio software. Android Studio offers enhanced
 editing and debugging features that are not available on the OnBot Java
-Programming Tool. However, it is a more complicated tool and is only
-recommended for advanced users.
+Programming Tool. However, it is a more complicated tool and you must
+spend time learning how to use it.
+It is only recommended for advanced users.
 
diff --git a/docs/source/programming_resources/shared/installing_kotlin/Installing-Kotlin.rst b/docs/source/programming_resources/shared/installing_kotlin/Installing-Kotlin.rst
@@ -61,15 +61,15 @@ done by adding the following lines to the root ``build.gradle`` file in the ``bu
 
     buildscript {
 
-        ext.kotlin_version = '1.8.20' <----- ADD THIS LINE, UPDATE VERSION TO LATEST IF NEEDED
+        ext.kotlin_version = '1.9.22' <----- ADD THIS LINE, UPDATE VERSION TO LATEST IF NEEDED
 
         repositories {
             mavenCentral()
             google()
         }
 
         dependencies {
-            classpath 'com.android.tools.build:gradle:7.2.0'
+            classpath 'com.android.tools.build:gradle:8.7.0'
             classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version" <----- ADD THIS LINE
         }
     }
diff --git a/docs/source/programming_resources/shared/managing_control_hub/Managing-a-Control-Hub.rst b/docs/source/programming_resources/shared/managing_control_hub/Managing-a-Control-Hub.rst
@@ -515,9 +515,9 @@ computer includes the path to the adb.exe executable file. The
 `Android Developer website <https://developer.android.com/tools/adb>`__
 tells you where in your Android SDK installation you can find the
 adb.exe file. This
-`post <https://helpdeskgeek.com/windows-10/add-windows-path-environment-variable/>`__
+`post <https://helpdeskgeek.com/add-windows-path-environment-variable/>`__
 from
-`HelpDeskGeek.com <https://helpdeskgeek.com/windows-10/add-windows-path-environment-variable/>`__
+`HelpDeskGeek.com <https://helpdeskgeek.com/add-windows-path-environment-variable/>`__
 shows how to add a directory to your Windows PATH environment
 variable.
 

Original file line number	Diff line number	Diff line change
@@ -61,15 +61,15 @@ done by adding the following lines to the root ``build.gradle`` file in the ``bu
`61`	`61`
`62`	`62`	`buildscript {`
`63`	`63`
`64`		`- ext.kotlin_version = '1.8.20' <----- ADD THIS LINE, UPDATE VERSION TO LATEST IF NEEDED`
	`64`	`+ ext.kotlin_version = '1.9.22' <----- ADD THIS LINE, UPDATE VERSION TO LATEST IF NEEDED`
`65`	`65`
`66`	`66`	`repositories {`
`67`	`67`	`mavenCentral()`
`68`	`68`	`google()`
`69`	`69`	`}`
`70`	`70`
`71`	`71`	`dependencies {`
`72`		`- classpath 'com.android.tools.build:gradle:7.2.0'`
	`72`	`+ classpath 'com.android.tools.build:gradle:8.7.0'`
`73`	`73`	`classpath "org.jetbrains.kotlin:kotlin-gradle-plugin:$kotlin_version" <----- ADD THIS LINE`
`74`	`74`	`}`
`75`	`75`	`}`