change ..image to ..figure, adjust image sizes for PDF presentation.

Author: acharraggi

docs/source/programming_resources/shared/choosing_program_lang/choosing-program-lang.rst

@@ -1,39 +1,63 @@
 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
+---------------------------
+
+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.
 
-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.
+.. figure:: images/BlocksPicture1.jpg
+   :alt: 
+   :width: 75%
+   :class: no-scaled-link 
+    
+   Blocks Programming Tool showing a graphical Blocks program.
 
-   .. image:: images/BlocksPicture1.jpg
-      :alt: Screenshot of the Blocks Programming Tool showing a graphical Blocks program.
+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.
 
-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.
+.. figure:: images/onBotJavaScreen.jpg
+   :alt: 
+   :width: 75%
+   :class: no-scaled-link 
+      
+   OnBot Java Programming Tool showing Java source code.
 
-   .. image:: images/onBotJavaScreen.jpg
-      :alt: Screenshot of the OnBot Java Programming Tool showing some Java source code.
+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.
 
-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.
+.. figure:: images/androidStudioScreen.jpg
+   :alt: 
+   :width: 50%
+   :class: no-scaled-link 
+    
+   Android Studio showing Java source code.
 
-   .. image:: images/androidStudioScreen.jpg
-      :alt: Screenshot of Android Studio showing some 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
@@ -45,8 +69,12 @@ The OnBot Java Programming Tool is similar to the Blocks Programming
 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.
+.. figure:: images/ipadPhoneChromebook.jpg
+   :alt: 
+   :width: 50%
+   :class: no-scaled-link 
+   
+   A tablet, phone, and 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,
@@ -57,6 +85,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.