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 index b4a76522..ab1031e5 100644 --- 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 `. -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.