风格指南

不要一概而论。

• 只有西斯才追求绝对

• 利用“优缺点”列表来比较各种选项

• 解释 为什么 某件事是好是坏

  • 例如，我们都知道Tetrix V2电机质量很差。但不要只是说它们质量差，而应该这样说：“Tetrix V2电机功率不足，在失速状态下往往几秒钟内就会烧毁，因此通常不建议使用。此外，它们也没有内置编码器。 我们强烈建议改购由 goBILDA、REV 和 AndyMark 销售的 RS-550/RS-555 系列电机。”

  • 同样，我们知道 goBILDA 电机总体上性能不错。 但请*解释*它们为何性能优良，例如：“如果您需要一款输出轴为 6mm D/8mm REX 的电机，通常建议选用 goBILDA Yellow Jacket 行星减速电机，特别是当您将 goBILDA 作为主要构建系统时。 这些电机配备了坚固的齿轮箱，通常能够承受相当大的冲击载荷（但在高扭矩情况下仍需进行支撑），并且可以方便地正面安装到 goBILDA 部件上。此外，goBILDA 电机无需使用电平转换器即可将其编码器与 REV 控制系统配合使用，灵活性很强。 请注意，您需要将圆柱形连接器适配到REV控制系统的电源线，而且与REV Robotics电机不同，goBILDA电机的电源线不可拆卸。”

• 仍要强调团队可以自由探索和创新，但要帮助设定切合实际的期望（参见下一点）

Game Manual 0 是一份 从竞技角度出发 的指南。

• 尽量省略那些效果不佳且不受欢迎的内容；如果某项技术很受欢迎，那么就值得说明其缺点（参见H驱动与球式驱动的对比； 解释H型传动作为一种相对流行且简单的传动系统是有意义的，但球式传动这种几乎不存在且极其复杂的传动系统，则没有必要提及）

• 尽量避免发表个人观点。在可能的情况下，不要对那些自己没有亲身经历的事情妄下断言。

• 请记住，FTC的设计趋势是暂时的、转瞬即逝的

  • 仅仅因为某样东西在一个赛季里很流行，并不意味着它就是万能的。 曾经有一段时间，六轮驱动和同轴转向驱动曾风靡一时，但这并不意味着我们应该在 Game Manual 0 中推荐它们。请尽量思考某样东西之所以流行是因为什么，以及它们在设计、功能和实现方面究竟能带来哪些实际好处。

请考虑到，并非所有团队都有足够的资源来为自己的设计购买最理想的零部件。

• 这意味着，我们应就如何缓解劣质零部件带来的问题提出建议。

  • 例如：TETRIX 结构有时会因容易弯曲而声名不佳，至少与其他构建系统（如 REV、goBILDA 和 Actobotics）相比是如此。 因此，我们建议在使用 TETRIX 搭建时，与其他系统相比应增加额外的支撑（这意味着需要添加额外的横杆，并在槽型件内部加装间隔柱以提高刚性）。

尽可能附上图片/视频。

• 添加机制示例确实有助于知识传递。

  • 请注明球队信息：标题格式为：[球队编号] [球队名称]，（相关成就），[赛季]，（描述）

    • [] 表示始终，() 表示在相关情况下

    • 如果同一支团队拍摄了同一部件的多张照片，请仅在最后一张照片上标注来源，以避免重复。

    • 示例

      • 11115 无麸质，联盟队长（底特律）决赛入围者，圣物回收，弹簧驱动

      • 8417 “Lectric Legends” 品牌，Rover Ruckus 车型，TPU 进气挡板

      • 7236 焕新绿，Rover Ruckus，Misumi SAR3

在可能的情况下，请遵守品牌标准。

• 请遵守 FIRST® 商标指南，可点击 此处 查看_

  • 页面中首次出现的 FIRST 和 FTC 应包含 |reg|（即 *FIRST*\ |reg|）

  • 名称*FIRST*必须始终大写并加粗

  • 请勿在 名字 上使用所有格（例如， 名字 的）

• 是 gm0，不是 GM0，该死；看看那个标志。

• 这一点也适用于球队名称：请按照其官方拼写方式书写

  • 如果您不确定某支球队的名称该怎么拼写，请查看 FTC 活动 。

写作时，如果这样能让行文更自然，你可以使用“你”。不过，尽量避免过度使用它。