Make the Android Studio tutorial a standalone, Driver Hub-first path - #426
Open
miriamsr wants to merge 6 commits into
Open
Make the Android Studio tutorial a standalone, Driver Hub-first path#426miriamsr wants to merge 6 commits into
miriamsr wants to merge 6 commits into
Conversation
Addresses FIRST-Tech-Challenge#407. - Add a 'Before You Start' page as the first section of the Android Studio tutorial. It states the recommended Control Hub + Driver Hub setup, describes the smartphone Robot Controller / Driver Station setups as alternates, links the hardware configuration and Control System pages a Java team needs, and adds a 'Before writing code' checklist with a link for each item. - Rewrite the tutorial landing page introduction so it describes a complete getting-started path rather than assuming the reader arrived from the Blocks tutorial, and name the recommended setup up front. - Add short orienting lead-ins to the Introduction, Configuring your Hardware, Installing Android Studio, and Writing an Op Mode section pages, noting which linked content applies only to the alternate smartphone setups. - Label the Enabling Developer Options entry as smartphone Robot Controller only, since a Control Hub ships with Developer Options enabled. - Link the computer requirements page from the install section; it was not reachable from Programming Resources.
- Drop the assertion that the Control Hub ships preloaded with the Robot Controller app; only the Driver Hub's preloaded DS app is documented. - Replace the invented Robot Controller / Driver Station version inequality with the sourced guidance: both come from the current season's release. - State the USB Type C deploy path positively instead of asserting that the Program & Manage network is not required.
Replaces the recommended/alternate-setup framing with the support boundary: the Control Hub and Driver Hub are officially supported, and smartphones are legal to use in competition but unsupported.
zachwaffle4
suggested changes
Aug 6, 2026
zachwaffle4
left a comment
zachwaffle4
left a comment
Contributor
There was a problem hiding this comment.
I would recommend updating the Android Studio screenshots because the UI has changed significantly.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
3 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Addresses #407.
What changed
All edits are confined to
programming_resources/android_studio_java/— noshared/page is touched, so the Blocks and OnBot Java tutorials are unaffected. No files were renamed, so noredirects.txtentries are needed.New page: Before You Start (
android_studio_java/before_you_start/before-you-start.rst), now the first entry in the tutorial's toctree. It:FtcRobotControllerproject, version compatibility, and the USB Type C deploy path (point 5).Landing page — the introduction previously claimed the tutorial covers "configuring, programming, and operating your Control System" while mostly linking out. Rewritten to describe the complete path it now actually provides, name the recommended setup up front, and point at Before You Start.
Section pages — the five section stubs were bare toctrees. Each now has a short lead-in saying what the section covers and, where relevant, which linked content applies only to the alternate smartphone setups. The
Enabling Developer Optionstoctree entry is relabeled "Enabling Developer Options (Smartphone Robot Controller)", since a Control Hub ships with Developer Options enabled.Incidental fix —
programming_resources/laptops/laptops(Computer Requirements) is not reachable from the Programming Resources index; it is now linked from the install section and from Before You Start, where an Android Studio team will actually look for it.Not covered here
Issue point 3 is only partly addressed. The smartphone-centric material lives inside
shared/pages:Using-Your-Android-Deviceis almost entirely smartphone content with a three-line Driver Hub stub, andConfiguring-Your-Android-Devicescarries a full "Two Android Smartphone Configuration" section. Those pages are also in the Blocks and OnBot Java toctrees, so rebalancing them changes all three tutorials and several:ref:targets. This PR reframes at the Android Studio layer only — ordering, link labels, and lead-in prose. The shared-page rewrite is worth a separate issue and a maintainer decision.Verification
cd docs && make html SPHINXOPTS="-W --keep-going -n"passes. The only warning is an unrelated network failure fetching the Sphinx intersphinx inventory (HTTP 429). No new images, no renames.