Gearing argument documentation is vague

[calcmogul]

It's unclear how to turn a gear ratio like 6.75:1 into the floating point argument users are supposed to plug in.

It should clarify a gear ratio is input:output (input to output), and that gets converted to input/output. A number greater than 1 is a reduction.

Every instance of the word gearing as an argument should be updated in the same way.

[chauser]

See also: wpilibsuite/frc-docs#1206
Different communities apparently have different conventions about whether a gear ratio like 6.75:1 should be considered input:output or output:input depending on whether they think a gear ratio is a turns ratio or a torque ratio. In response to docs issue 1206, clarifying language was added to drivetrain-model.rst using the torque ratio convention (output/input). (My preference would have been to document it with the turns ratio convention, as preferred in this issue, but the language is clear about what convention is in use and that's what matters most.)