Skip to content

Comments

Javadoc formatting#118

Merged
SpectrumFRC3847 merged 4 commits intodocformatfrom
javadoc-format
Oct 9, 2025
Merged

Javadoc formatting#118
SpectrumFRC3847 merged 4 commits intodocformatfrom
javadoc-format

Conversation

@SpectrumFRC3847
Copy link
Contributor

No description provided.

Co-authored-by: Project516 <138796702+Project516@users.noreply.github.com>
@SpectrumFRC3847 SpectrumFRC3847 marked this pull request as ready for review October 9, 2025 22:35
Copilot AI review requested due to automatic review settings October 9, 2025 22:35
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull Request Overview

This PR improves Javadoc formatting across multiple Java files by enhancing parameter and return value documentation. The changes focus on making API documentation more clear and complete.

Key changes:

  • Fixed string comparison issue in LimelightHelpers using proper null-safe string comparison
  • Enhanced Javadoc comments with proper parameter descriptions and return value documentation
  • Removed unused import and formatted method documentation

Reviewed Changes

Copilot reviewed 13 out of 14 changed files in this pull request and generated no comments.

Show a summary per file
File Description
LimelightHelpers.java Fixed string comparison bug and improved Javadoc formatting for vision methods
Limelight.java Enhanced method documentation and removed unused import
Mechanism.java Improved Javadoc comments for motor control methods
Gamepad.java Enhanced constructor documentation formatting
SpectrumState.java Added parameter and return value documentation
Vision.java Improved method documentation for vision system
Swerve.java Enhanced zone checking method documentation
StateChampsOffsets.java Added parameter and return documentation
Zones.java Fixed HTML entities and improved method documentation
TagProperties.java Enhanced constructor parameter documentation
FieldHelpers.java Comprehensive improvement of method documentation
Trigger.java Fixed parameter name documentation
gradle.properties Added Gradle caching configuration

Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.

Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull Request Overview

Copilot reviewed 14 out of 15 changed files in this pull request and generated 4 comments.


Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.

* Closed-loop Velocity with torque control (requires Pro)
*
* @param velocity rotations per second
* @param velocityRPS rotations per second
Copy link

Copilot AI Oct 9, 2025

Choose a reason for hiding this comment

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

Parameter name mismatch: the method parameter is velocityRPS but the Javadoc incorrectly refers to it as velocity. The documentation should match the actual parameter name.

Copilot uses AI. Check for mistakes.
* @param rearCenterOffsetInchesLeft Rear center offset in inches for left side
* @param rearCenterOffsetInchesRight Rear center offset in inches for right side
* @param taGoal Target area goal
* @param angleDegrees Angle in degrees
Copy link

Copilot AI Oct 9, 2025

Choose a reason for hiding this comment

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

Parameter name mismatch: the constructor parameter is angle but the Javadoc refers to angleDegrees. The documentation should match the actual parameter name.

Copilot uses AI. Check for mistakes.
SpectrumFRC3847 and others added 2 commits October 9, 2025 17:44
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
Co-authored-by: Copilot <175728472+Copilot@users.noreply.github.com>
@SpectrumFRC3847 SpectrumFRC3847 marked this pull request as draft October 9, 2025 22:44
Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull Request Overview

Copilot reviewed 14 out of 15 changed files in this pull request and generated no new comments.

Comments suppressed due to low confidence (1)

src/main/java/frc/reefscape/Zones.java:1

  • Good fix! Using HTML entities &lt; and &gt; instead of < and > is the correct way to represent these symbols in Javadoc comments.
package frc.reefscape;

Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.

Copy link
Contributor

Copilot AI left a comment

Choose a reason for hiding this comment

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

Pull Request Overview

Copilot reviewed 14 out of 15 changed files in this pull request and generated no new comments.


Tip: Customize your code reviews with copilot-instructions.md. Create the file or learn how to get started.

@SpectrumFRC3847 SpectrumFRC3847 changed the base branch from main to docformat October 9, 2025 22:47
@SpectrumFRC3847 SpectrumFRC3847 marked this pull request as ready for review October 9, 2025 22:47
@SpectrumFRC3847 SpectrumFRC3847 merged commit 2512cf4 into docformat Oct 9, 2025
1 check passed
@SpectrumFRC3847 SpectrumFRC3847 deleted the javadoc-format branch October 9, 2025 22:48
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