风格指南

不要绝对化。

• 只有西斯才会绝对地交易(译者注：星球大战的梗)

• 使用优点/缺点列表来比较各种选择

• 解释 为什么 某事是好的或坏的

  • 例如，我们都知道 Tetrix V2 电机很糟糕。但不要只说它们不好，应该说”Tetrix V2 电机功率不足，在失速情况下往往会在几秒钟内烧毁，因此一般不推荐使用。它们也没有内置编码器。我们强烈建议购买由 goBILDA、REV 和 AndyMark 出售的 RS-550/RS-555 级电机”。

  • 同样，我们知道 goBILDA 电机一般都不错。但请 解释 它们为什么好，例如：”如果你需要 6mm D/8mm REX 输出轴电机，尤其是如果你将 goBILDA 作为你的主要构建系统，一般推荐使用 goBILDA Yellow Jacket 行星电机。这些电机有一个坚固的齿轮箱，通常可以承受相当大的冲击负荷（但在高扭矩情况下仍必须有支撑），而且可以方便地安装到 goBILDA 部件上。此外，goBILDA 电机在使用其编码器和 REV 控制系统时不需要使用水平移动器，因此灵活性很高。请注意，你需要将子弹头连接器改装成 REV 控制系统电源线，而且 goBILDA 电机电源线与 REV 机器人电机不同，是不可拆卸的。”

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

Game Manual 0 是一份 从竞争性角度来看的 指南。

• 尽量不提那些不好用、不受欢迎的东西；如果是受欢迎的东西，就值得解释其缺点（如 H 驱动与滚珠驱动的对比；解释 H 驱动是一种相对受欢迎且简单的传动系统是有意义的，但滚珠驱动是一种几乎不存在且复杂得令人发指的传动系统，提出来毫无意义）。

• 尽量不发表意见。对于没有亲身经历的事情，尽可能不要发表权威性意见

• 请记住，FTC的设计趋势一直在变动，一个趋势的寿命往往很短。

  • 某一季流行的东西并不意味着它就是全部。曾几何时，6轮驱动和同轴转向驱动风靡一时，但这并不意味着我们应该在 Game Manual 0 中推荐它们。试着思考一下为什么某些东西会流行，它们在设计、功能和执行方面究竟能带来什么好处。

考虑到并非所有团队都有足够的资源为自己的设计购买最合适的部件，

• 这意味着我们应该就如何减少劣质部件的问题提出建议。

  • 例如：TETRIX 结构有时会弯曲，这一点名声不好，至少与 REV、goBILDA 和 Actobotics 等其他构建系统相比是这样。因此，与其他系统相比，我们建议在使用 TETRIX 构建时增加额外的支撑（这意味着包括额外的横梁和在通道内增加支座，以增加刚度）。

尽可能附上图片/视频。

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

  • 记入各队名下：标题格式为[队号] [队名]，（相关成就），[赛季]，（说明）(译者注：由于有些时候图片标记使用了没有修饰词的专业术语，我们在翻译时会机上一些修饰词来使其通顺，原文中没有。如：“设计的……装置”)

    • [ ]表示所有时间，( )表示相关时间

    • 如果你有来自同一团队的同一角色的多张照片，请只在最后一张上注明，以避免重复。

    • 示例

      • 11115 Gluten Free队伍，Finalist Alliance Captain (Detroit)，Relic Recovery，设计的弹簧加载装置

      • 8417 ‘Lectric Legends, Rover Ruckus, TPU 设计的进气口挡板

      • 7236 Recharged Green，Rover Ruckus，设计制造的Misumi SAR3

尽可能遵守品牌标准。

• 遵守 FIRST® 商标指南， 可从这里获取

  • 页面上 FIRST 和 FTC 的第一个实例应包括 ® (即 FIRST®)。

  • 始终大写并斜体标注 FIRST 名称

  • 不要在 FIRST 名称上使用所有格（如 FIRST’s）

• 务必注意：这篇文档的名字是小写的gm0，不是大写的GM0！如果还不清楚，就看看标志。

• 这也适用于队名：按正式拼写方式拼写

  • 如果不知道团队名称的拼写，请查看 The Orange Alliance 或 FTC Events 。

在写作时，可以使用 “你”，这样可以减少写作时的尴尬。但要尽量避免过度使用。