Skip to content

Point computer requirements page to FIRST's official PDF - #456

Merged
texasdiaz merged 1 commit into
mainfrom
update-laptop-requirements
Oct 2, 2026
Merged

texasdiaz merged 1 commit into
mainfrom
update-laptop-requirements

Conversation

@texasdiaz

Copy link
Copy Markdown
Contributor

Summary

The laptop requirements have been updated for this season, and we've been asked to point to FIRST's official computer requirements PDF instead of maintaining our own per-program breakdown here:
https://info.firstinspires.org/hubfs/web/program/all/computer-requirements.pdf

  • Kept the introductory paragraph and the "factors that affect requirements" list in programming_resources/laptops/laptops.rst.
  • Replaced the "Program-Specific Requirements" section (and the "Recommended Hardware Sets" section it referenced) with a link to the official PDF.
  • Generalized the intro away from naming "FIRST LEGO League, FIRST Tech Challenge, and FIRST Robotics Competition" specifically, since the program lineup is changing soon and enumerating them is exactly what would go stale again - it now just says "FIRST programs".
  • Updated tech-tip-ftc-docs-resources.rst's description of this page, since it previously described the detailed per-program breakdown that's now removed.

Test plan

  • Full Sphinx build with -W (warnings-as-errors) succeeds - confirmed no other page references the removed subsections (only the page's own title heading is referenced elsewhere, which was kept)
  • cspell reports 0 issues
  • Verified the new PDF URL returns 200 application/pdf
  • Caught and fixed a real rendering bug along the way: RST doesn't parse emphasis nested inside link text, so the FIRST-branded link text was rendering literal asterisks - reworded to put the italics outside the link

Generated with Claude Code

…ting them

The detailed per-program hardware recommendations and model suggestions
were going stale and are being superseded. Keeps the introductory
"why a computer requirements page exists" content, but replaces the
Program-Specific Requirements and Recommended Hardware Sets sections
with a link to FIRST's official, centrally-maintained Computer
Requirements PDF.

Also generalizes the intro away from naming "FIRST LEGO League, FIRST
Tech Challenge, and FIRST Robotics Competition" specifically -- per
request, since the FIRST program lineup is changing soon and
enumerating them here is exactly what would go stale again.

Updated tech-tip-ftc-docs-resources.rst's description of this page,
since it previously described the removed per-program breakdown.

Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com>
@texasdiaz
texasdiaz merged commit 3e58271 into main Oct 2, 2026
8 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant