文档贡献规则

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.

使命宣言

WPILib 的任务是让 FIRST 机器人团队专注于编写游戏专用软件，而不是专注于硬件细节—— “raise the floor, don’t lower the ceiling” 。我们致力于使具有有限编程知识和/或指导经验的团队尽可能成功，同时不妨碍具有更高级编程能力的团队的能力。我们在库中直接支持零件控制系统组件套件。我们还努力保持每个语言（java，C++，和 NI 的 LabVIEW）的主要特征之间的奇偶性，这样团队就不会因为选择特定的编程语言而处于不利的地位。

这些文档为所有 FIRST 机器人竞赛团队提供了一个学习场所。对该项目的捐赠必须遵循这些核心原则。

  • 社区主导的文档。文档来源是公开托管的，社区可以参与捐赠

  • 结构化、格式好、清晰的文档。从源代码和发布的角度来看，文档应该是干净且易于阅读的

  • 息息相关。文档应该集中注意在* FIRST *机器人大赛上。

查阅:ref:`docs/contributing/frc-docs/style-guide:Style Guide`了解如何规范化您的文档。

发布过程

frc-docs使用特殊的发行过程来处理主站点``/ stable /’’和开发站点``/ latest /’’。该流程将在下面详细说明。

During Season:

  • Commit made to main branch

    • 更新网站上的 /stable/``和/latest/``

End of Season:

  • Repository is tagged with year, for archival purposes

Off-Season:

  • stable branch is locked to the last on-season commit

  • Commit made to main branch

    • 指更新文档站点中的``/latest/``

创建一个PR

PRs should be made to the frc-docs repo on GitHub. They should point to the main branch and not stable.

增加新内容

Thanks for contributing to the frc-docs project! There are a couple things you should know before getting started!

文章放在哪呢?

新文章的位置可能是一个很主观的问题。属于现存主题分类的独立文章应放在提及的主题类别中（有关模拟的文档应放在模拟部分中）。但是，当文章结合或引用两个单独的现有部分时，事情可能会变得非常复杂。在这种情况下，我们建议作者在打开PR之前先在存储库中打开一个repository，以进行讨论。

备注

所有新文章在合并到repository之前都将经过审核过程。审核过程将由WPILib团队的成员来完成。新文章必须在受* FIRST *支持的官方软件和硬件上。 关于非官方图书馆或传感器的文件不会被接受。该过程可能需要一些时间进行审核，请耐心等待。

在哪里放置章节?

Sections are quite tricky, as they contain a large amount of content. We advise the author to open an issue to gather discussion before opening up a PR.