frc-4931/2015-Robot — pull request #4 by Zabot (2014-12-09 23:24:05+00:00)
Title: Additional API interfaces and implementations

This should get us up to speed on most of the API stuff, in this PR we've got interfaces and implementations for:
* Motors
* Gyroscopes
* Distance Sensors

The only thing missing from last years robot is the accelerometer

It also adds the `LimitedMotor` composite class and JUnit test cases, which though similar in concept to `SolenoidWithPostion`, isn't worth trying to abstract.

Aside from that I fixed some documentation and refactored Hardware so that similar factory methods are in nested classes.

Some things that might be worth considering:
* The `Hardware` and `Mock` prefixes are a little overkill, the names are different enough to prevent conflicts, and if not, they're in separate packages.
* If we are going to rely on the accelerometer and gyroscope more heavily then last year, it might be beneficial to have some helper classes that allow us to attach units and direction to a value, e.g. `Angle`, `Velocity`, `Displacement`, etc.