[FRC Blog] Documentation: Reboot

[bdaroz]

From http://www.firstinspires.org/robotic...ntation-reboot posted Dec 1 2016

Documentation: Reboot
Written by Kate Pilotte, FIRST Robotics Competition Kit of Parts Manager, on behalf of a cross-functional team.


There’s a lot of stuff for an FRC team to comb through each season. There’s been a sense that, in the interest of being thorough, sometimes we’re redundant. This can be especially true as documentation evolves over years.

A group of us from Marketing, Operations, and FRC got together over the past few months to review how the Admin and Game Manuals have evolved, the content they cover, where that content may already be published, and filter content between evergreen (can be published/updated throughout the calendar year) and season specific (most appropriately posted on Kickoff Day because it’s deliberately a secret or doesn’t add any value before Kickoff).

As a result, the Admin Manual’s been… dissolved. Its content was either already (or will be) on the FIRST site, integrated in to the single 2017 Game and Season Manual, or deemed just not that important and deleted. Evergreen content not already on the site is being added throughout the fall. In case you’re curious, there’s a more specific dispositioning list here.

The 2017 Game and Season Manual will be longer than last year’s Game Manual, but I promise it’s shorter than last year’s Game and Admin manual combined – and we hope a more concise resource.

Minor updates and edits to evergreen content will be done as routine website maintenance, and posting of new “important” content will be announced via the FRC social media channels (Twitter, Facebook) or described more deeply in this blog.

Ed: Links are as published, please don't blame me