Welcome to the contribution guidelines for the frc®-docs project. If you are unfamiliar to writing in the reStructuredText format, please read up on it here.
FIRST® retains all rights to documentation and images provided. Credit for articles/updates will be in the GitHub commit history.
The WPILib Mission is to enable FIRST Robotics teams to focus on writing game-specific software rather than focusing on hardware details - “raise the floor, don’t lower the ceiling”. We work to enable teams with limited programming knowledge and/or mentor experience to be as successful as possible, while not hampering the abilities of teams with more advanced programming capabilities. We support Kit of Parts control system components directly in the library. We also strive to keep parity between major features of each language (Java, C++, and NI’s LabVIEW), so that teams aren’t at a disadvantage for choosing a specific programming language.
These docs serve to provide a learning ground for all FIRST Robotics Competition teams. Contributions to the project must follow these core principles.
Community-led documentation. Documentation sources are hosted publicly and the community are able to make contributions
Structured, well-formatted, clean documentation. Documentation should be clean and easy to read, from both a source and release standpoint
Relevant. Documentation should be focused on the FIRST Robotics Competition.
Please see the Style Guide for information on styling your documentation.
frc-docs uses a special release process for handling the main site
/stable/ and the development site
/latest/. This flow is detailed below.
- Commit made to
/latest/on the website
End of Season: - Repository is tagged with year, for archival purposes
stable branch is locked to the last on-season commit
- Commit made to
/latest/on the documentation site
Creating a PR¶
PRs should be made to the frc-docs repo on GitHub. They should point to the
master branch and not
Creating New Content¶
Thanks for contributing to the frc-docs project! There are a couple things you should know before getting started!
Where to place articles?¶
The location for new articles can be a pretty opinionated subject. Standalone articles that fall well into an already subject category should be placed into mentioned subject category (documentation on something about simulation should be placed into the simulation section). However, things can get pretty complicated when an article combines or references two separate existing sections. In this situation, we advise the author to open an issue on the repository to get discussion going before opening the PR.
All new articles will undergo a review process before being merged into the repository. This review process will be done by members of the WPILib team. New Articles must be on official FIRST supported Software and Hardware. Documentation on unofficial libraries or sensors will not be accepted. This process may take some time to review, please be patient.