Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Add alt text to the Choosing a Programming Tool page. #327

Draft
wants to merge 3 commits into
base: main
Choose a base branch
from
Draft
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Original file line number Diff line number Diff line change
@@ -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
Expand All @@ -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,
Expand All @@ -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.