Guía de estilo

No trates con absolutos.

• Sólo un Sith trata con absolutos

• Utilizar listas de pros y contras para comparar opciones

• Explicar POR QUÉ algo es bueno o malo

  • Por ejemplo, todos sabemos que los motores Tetrix V2 son malos. Pero no se limiten a decir que son malos, digan: «Los motores Tetrix V2 no tienen potencia suficiente y suelen quemarse en pocos segundos al entrar en puesta, por lo que no suelen recomendarse. Tampoco tienen codificadores integrados. Recomendamos encarecidamente comprar motores de la clase RS-550/RS-555 vendidos por goBILDA, REV y AndyMark».

  • Del mismo modo, sabemos que los motores goBILDA son generalmente buenos. Pero explique por qué son buenos, por ejemplo: «Los motores planetarios Yellow Jacket de goBILDA se recomiendan generalmente si necesita un motor con eje de salida REX de 6 mm D/8 mm, y especialmente si utiliza goBILDA como sistema de construcción principal. Estos motores tienen una caja de engranajes robusta que por lo general puede manejar una cantidad decente de carga de choque (pero todavía debe ser apoyado en situaciones de alto torque) y convenientemente se monta frontalmente en piezas goBILDA. Además, los motores goBILDA no requieren el uso de un desplazador de nivel para utilizar sus codificadores con el sistema de control REV para mayor flexibilidad. Tenga en cuenta que tendrá que adaptar los conectores bullet a los cables de alimentación del sistema de control REV, y que los cables de alimentación de los motores goBILDA no son extraíbles, a diferencia de los motores REV Robotics.»

• Siga insistiendo en que los equipos son libres de explorar e innovar, pero ayude a establecer expectativas realistas (véase el siguiente punto)

Game Manual 0 es una guía desde un punto de vista competitivo.

• Intenta omitir las cosas que no funcionan bien y no son populares; si son populares, vale la pena explicar las desventajas (por ejemplo, chasis en H vs chasis por bolas; explicar el chasis en H, como un chasis relativamente popular y sencillo, tiene sentido, pero el chasis por bolas, un chasis que apenas existe y que es ridículamente complicado, no tiene sentido mencionarlo).

• Intente dejar de lado las opiniones en la medida de lo posible. Siempre que sea posible, no hables con autoridad sobre temas en los que no tengas experiencia de primera mano.

• Tenga en cuenta que las tendencias de diseño de FTC son temporales y transitorias

  • Sólo porque algo sea popular una temporada no significa que sea el fin de todo. Hubo un tiempo en el que las 6 ruedas motrices y los swerve drives coaxiales estaban de moda, pero eso no significa que debamos recomendarlos en Game Manual 0. Intenta pensar por qué algo es popular y qué ventajas de diseño, función y ejecución aportan.

Tenga en cuenta que no todos los equipos disponen de los recursos necesarios para adquirir las piezas más óptimas para su diseño.

• Esto significa que debemos dar recomendaciones sobre cómo mitigar los problemas con piezas de mala calidad.

  • Por ejemplo: La estructura TETRIX tiene mala reputación por doblarse a veces, al menos comparada con otros sistemas de construcción como REV, goBILDA y Actobotics. Por lo tanto, recomendamos añadir soporte adicional cuando se construye en TETRIX en comparación con otros sistemas (esto significa incluir travesaños adicionales y añadir separadores dentro del canal para aumentar la rigidez).

Incluya imágenes/vídeos siempre que sea posible.

• Añadir ejemplos de mecanismos ayuda mucho a la transferencia de conocimientos.

  • Créditos a los equipos: El formato del pie de foto es: [Número del equipo] [Nombre del equipo], (logro relevante), [temporada], (descripción)

    • []s significa todo el tiempo, ()s significa cuando es relevante

    • Si tiene varias fotos de la misma parte del mismo equipo, acredítelas sólo en la última para evitar repeticiones.

    • Ejemplos

      • 11115 Gluten Free, Capitán de la Alianza Finalista (Detroit), Relic Recovery, equipado con resortes

      • 8417 “Lectric Legends, Rover Ruckus, aletas de intake TPU

      • 7236 Recharged Green, Rover Ruckus, Misumi SAR3

Cumplir las normas de la marca siempre que sea posible.

• Respete las directrices sobre marcas comerciales, disponibles en <https://www.firstinspires.org/sites/default/files/uploads/resource_library/UseofUSFIRSTandLEGOGroupTrademarksandCopyrightedMaterials.pdf>.

  • La primera instancia de FIRST y FTC en una página debe incluir ® (es decir, FIRST®)

  • Escriba siempre el nombre FIRST en mayúsculas y cursiva

  • NO utilice un posesivo en el FIRST nombre (por ejemplo, FIRST’s)

• Es gm0 no GM0 maldita sea; mira el logo.

• Esto también se aplica a los nombres de los equipos: escríbelos como se escriben oficialmente.

  • Consulte The Orange Alliance o FTC Events si no sabe cómo se escribe el nombre de un equipo.

Puedes utilizar el «tú» al escribir, cuando haga que la redacción resulte menos incómoda. Sin embargo, intenta evitar utilizarlo en exceso.