added javadoc and clearer names for shifting drivetrain gear

Author: dfang314

Robot2018/src/org/usfirst/frc/team199/Robot2018/commands/ShiftHighGear.java

@@ -27,7 +27,7 @@ protected void initialize() {
 
 	// Called repeatedly when this Command is scheduled to run
 	protected void execute() {
-		Robot.dt.pushGear(true);
+		Robot.dt.changeShiftGear(true);
 		SmartDashboard.putBoolean("High Gear", true);
 	}
 

Robot2018/src/org/usfirst/frc/team199/Robot2018/commands/ShiftLowGear.java

@@ -27,7 +27,7 @@ protected void initialize() {
 
 	// Called repeatedly when this Command is scheduled to run
 	protected void execute() {
-		Robot.dt.pushGear(false);
+		Robot.dt.changeShiftGear(false);
 		SmartDashboard.putBoolean("High Gear", false);
 	}
 

Robot2018/src/org/usfirst/frc/team199/Robot2018/subsystems/Drivetrain.java

@@ -49,7 +49,13 @@ public class Drivetrain extends Subsystem implements PIDOutput, PIDSource {
 	private final AnalogGyro dtGyro = RobotMap.dtGyro;
 	private final DoubleSolenoid dtGear = RobotMap.dtGear;
 
-	public void pushGear(boolean forw) {
+	/**
+	 * Activates the solenoid to push the drivetrain into low or high gear
+	 * 
+	 * @param forw
+	 *            if the solenoid is to be pushed forward or not
+	 */
+	public void changeShiftGear(boolean forw) {
 		if (forw ^ Robot.getBool("Drivetrain Gear Shift Backwards", false)) {
 			dtGear.set(DoubleSolenoid.Value.kForward);
 		} else {