Skip to content

Conversation

mannguyen4624
Copy link
Contributor

No description provided.

public static final int ULTRASONIC_TX = 1;

// Port of gyro
public static final int GYRO = 0;
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We know the RobotMap class is full of port numbers, eliminate that from the comments throughout the class


/**
*
* Command to lower the gear placer to safely drive.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We know this is a command. Write the purpose only


/**
*
* Command that brings gear placer up to give the lift a gear.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Don't label as a command in the docs

import edu.wpi.first.wpilibj.command.Subsystem;

/**
* Similar to GearPlacer class but uses a servo instead.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Don't reference another class without an explicit JavaDoc link.

package com.nutrons.nu17;

public class RobotMap {

Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The bit that said they were wheels was helpful. Add a comment:
// Wheel motors

public static final int BACK_RIGHT = 3;

// Ports of intake
public static final int ROLLER_A = 0;
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Which ones are A and B? Top/Bottom? Left/Right? Specify. If you don't know, put that in a TODO comment

public static final int MICRO_SWITCH = 0;

// Ports of encoders
public static final int DT_ENCODER_1 = 1;
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

A number tells us nothing. Where are these on the robot?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

We'll be using CANTalons so we won't need these anymore.

public static final int SHOOT_ENCODER_2 = 1;

// Port of joysticks
public static final int JOYSTICK1 = 0;
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

which joysticks? The number does not tell me anything


import com.nutrons.nu17.Robot;

import edu.wpi.first.wpilibj.command.Command;
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

These descriptions are for commands. Write them like commands i.e. "Raise the gear placer" instead of "Raises the gear placer"


/**
* Similar to GearPlacer class but uses a servo instead.
* Similar to {@link GearPlacer} class but uses a servo instead.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Perhaps this should extend the GearPlacer class or alternately you should have an interface that abstracts over both.

@MiloDavis
Copy link
Contributor

@sytect Fix merge conflicts

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants