FIRST Robotics Competition Blog

Documentation Iteration

Dec 10, 2021 Written by Kate Pilotte, Sr. Kit of Parts Manager

Subscribe

 

Did you know that there are two game design teams in FIRST Robotics Competition?

One team works on the even-year games; the other team is… odd.

Did you know that, even though each season typically brings a new game (COVID), there’s content that applies to even and odd years?

For that stuff, which we refer to as “evergreen,” the two teams collaborate, discuss, debate, calmly advocate, actively listen, and openly consider various directions to take those topics (only a few tables flipped!) such that when we agree to adopt an evergreen standard, it remains relatively consistent from year to year – even as game-specific content is wildly and excitingly reinvented for each new game.

One of the evergreen efforts the teams tackled over the last year was to revise how information was presented in the game manual and what norms we wanted to revisit and revise. The motivations/value statements used in this effort included the following, in no particular order:

  • organize content in an intuitive way (so that regardless of how seasoned or new you are to FIRST Robotics Competition, you can navigate the document efficiently)
  • increase transparency re: content that is unlikely to change each year (so, if someone was new to FIRST, they could get a head start on studying manual content before Kickoff by focusing on that evergreen content)
  • lock-in numbering for rules that are unlikely to change each year (so that members of the community don’t need to update their brains with the new “keep it together” rule).
  • better meet the needs of the wide range of FIRST Robotics Competition community members

The four major changes that came from this effort are…

  1. The “Safety” and “Conduct” sections were dissolved, and those rules have been incorporated into the existing sections on a best-fit basis.
  2. Any rules we don’t expect to change much are marked with green rule numbers and headlines.

We cannot yell this loudly enough… this is not permission for all you seasoned FIRSTers to skip over these rules! Please, please read through the complete rule set at least once each season. We are begging you.

  1. Rules that aren’t expected to change from season to season start their respective sections (thus minimizing, if not eliminating, the chance that their rule numbers will ever change)
  2. A new numbering scheme that informs the rule’s section, subsection, and position in the subsection was adopted.

To see how we formally describe all that, here are excerpts from the 2022 Manual, Section 1.8 This Document & Its Conventions (spoiler alert, there will be game rules for robots):

The rule numbering method indicates the section, subsection, and position of the rule within that subsection. The letter indicates the section in which the rule is published.

  • G for Section 7 Game Rules: ROBOTS
  • H for Section 8 Game Rules: Humans
  • R for Section 9 ROBOT Construction Rules
  • I for Section 10 Inspection and Eligibility Rules
  • T for Section 11 Tournaments

The following digit(s) represents the subsection in which the rule can be found. The final digits indicate the rule’s position within that subsection.

...

Rules include colloquial language, also called headlines, in an effort to convey an abbreviated intent of the rule or ruleset. There are two versions of headline formatting. Evergreen rules, or rules which are expected to go relatively unchanged from season to season, are indicated with a leading asterisk and their rule number and headline are presented in bold green text. “Relatively unchanged” means that the overall intent and presence of the rule from season to season is constant, but game-specific terms may be updated as needed (e.g.  changing Power Cells to <REDACTED> in a rule about what COACHES may not contact during a MATCH). These rules also start their respective section, so their rule number is not expected to change from season to season.

The rule numbering format is also being applied to an updated version of the Event Rules document, to be released before Kickoff (soon!).

One more manual update we wanted to share ahead of Kickoff… for a long time, the use of the term “student” (for the purposes of drive team membership, who has to be present for robot inspection, and who can ask questions of a referee) specified someone who is “pre-college.” This language implied that all students in FIRST are destined for college, which we know isn’t and shouldn’t be true for everyone (college is great, but it’s not necessarily right or right now for everyone – there are so many great post-secondary school opportunities!). As a result, the formal definition of student is now “a person who has not completed high-school, secondary school, or the comparable level as of September 1 prior to Kickoff.” That doesn’t mean that someone who doesn’t meet this formal definition can’t be on a FIRST Robotics Competition team, or even identified as a student on the team’s roster – it just means for rules where the formal definition of student is invoked, anyone not meeting that criterion isn’t eligible for that role.

We’ll post an encrypted version of the RAPID REACT presented by The Boeing Company Game Manual the week before Kickoff so that you can have it at the ready come Kickoff Day. Stay tuned to the FIRST Robotics Competition Blog, team blasts, and/or FIRST Robotics Competition social media channels to see when that’s available.

Good luck this season, and be sure to Read the FIRST Manual!

Back to Blog

Comments

As a readability improvement, it should be noted that it's possible to get confused between the subsection and position numbers with this, particularly in the event that there are at least 10 subsections in a section. (For 2020-2021, the Tournament and Robot sections both fit that bill.) May I suggest that a delimiter (a period or comma, most likely) be placed between the subsection and position? For the noted rule number, this would change R710 to R7.10

Thank you for taking the time to share your thoughts. I’ve shared them with the rest of the team for consideration.

Add new comment