Completely describe Ladybug configuration

Author: cmacfarl

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

@@ -24,16 +24,6 @@ to verify that your system satisfies the list of minimum requirements:
 *  `MacOS <https://developer.android.com/codelabs/basic-android-kotlin-compose-install-android-studio#3>`__
 *  `Linux <https://developer.android.com/codelabs/basic-android-kotlin-compose-install-android-studio#5>`__
 
-Java Development Kit
-~~~~~~~~~~~~~~~~~~~~
-
-Earlier versions of Android Studio required that the user install the
-Java Development Kit software separately. Versions of Android
-Studio up to, and including, Koala incorporate a compatible JDK (Java Development Kit)
-as part of the entire install package. It is not necessary, or recommended, 
-to install the Java Development Kit separately if you are using an Android Studio
-version between Chipmunk and Koala. Instead, it is recommended that you
-use the Java Development Kit that is included with Android Studio.
 
 .. caution:: 
 
@@ -46,7 +36,7 @@ use the Java Development Kit that is included with Android Studio.
    an error will be displayed during the Gradle sync and Android Studio will recommend that
    you upgrade Gradle.  Do not upgrade Gradle.
 
-   For more detailed instructions see: https://ftc-community.firstinspires.org/t/unable-to-connect-to-control-hub-in-android-studio-ladybug/1132/3
+   For more detailed instructions see: Configuring
 
 
 
@@ -80,3 +70,71 @@ Once the setup package has downloaded, launch the application and follow
 the on-screen instructions to install Android Studio.
 
 
+Configuring Android Studio (Ladybug and later)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+See the Caution above for why this is necessary.
+
+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 labelled 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
+
+|
+
+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
+
+|
+
+Do not do this.  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
+
+|
+
+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
+
+|
+
+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.
+
+
+
+