Skip to content
This repository was archived by the owner on Oct 28, 2025. It is now read-only.

Commit 48ee55a

Browse files
committed
Remove extraneous @return tag
1 parent e8e189e commit 48ee55a

16 files changed

Lines changed: 154 additions & 145 deletions

src/main/java/com/thebluealliance/api/v3/models/Award.java

Lines changed: 6 additions & 6 deletions
Original file line numberDiff line numberDiff line change
@@ -19,35 +19,35 @@ public class Award {
1919
String event_key;
2020

2121
/**
22-
* @return Integer representing the type of award given.
22+
* Integer representing the type of award given.
23+
*
2324
* @see <a href="https://github.com/the-blue-alliance/the-blue-alliance/blob/master/consts/award_type.py#L6">award_type.py</a>
2425
*/
2526
int award_type;
2627

2728
/**
28-
* @return The year this award was won.
29+
* The year this award was won.
2930
*/
3031
int year;
3132

3233
/**
33-
* @return A list of recipients of the award at the event.
34+
* A list of recipients of the award at the event.
3435
*/
3536
AwardRecipient[] recipient_list;
3637

37-
3838
/**
3939
* An <code>AwardRecipient</code> object represents the team and/or person who received an award at an event.
4040
*/
4141
@Value
4242
public class AwardRecipient {
4343

4444
/**
45-
* @return The TBA team key for the team that was given the award. May be <code>null</code>.
45+
* The TBA team key for the team that was given the award. May be <code>null</code>.
4646
*/
4747
String team_key;
4848

4949
/**
50-
* @return The name of the individual given the award. May be <code>null</code>.
50+
* The name of the individual given the award. May be <code>null</code>.
5151
*/
5252
String awardee;
5353
}

src/main/java/com/thebluealliance/api/v3/models/District.java

Lines changed: 4 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -9,22 +9,22 @@
99
public class District {
1010

1111
/**
12-
* @return The short identifier for the district.
12+
* The short identifier for the district.
1313
*/
1414
String abbreviation;
1515

1616
/**
17-
* @return The long name for the district.
17+
* The long name for the district.
1818
*/
1919
String display_name;
2020

2121
/**
22-
* @return Key for this district, e.g. <code>2016ne</code>.
22+
* Key for this district, e.g. <code>2016ne</code>.
2323
*/
2424
String key;
2525

2626
/**
27-
* @return Year this district participated.
27+
* Year this district participated.
2828
*/
2929
int year;
3030
}

src/main/java/com/thebluealliance/api/v3/models/DistrictRanking.java

Lines changed: 5 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -9,27 +9,27 @@
99
public class DistrictRanking {
1010

1111
/**
12-
* @return TBA team key for the team.
12+
* TBA team key for the team.
1313
*/
1414
String team_key;
1515

1616
/**
17-
* @return Numerical rank of the team, 1 being top rank.
17+
* Numerical rank of the team, 1 being top rank.
1818
*/
1919
int rank;
2020

2121
/**
22-
* @return Any points added to a team as a result of the rookie bonus.
22+
* Any points added to a team as a result of the rookie bonus.
2323
*/
2424
int rookie_bonus;
2525

2626
/**
27-
* @return Total district points for the team.
27+
* Total district points for the team.
2828
*/
2929
int point_total;
3030

3131
/**
32-
* @return List of events and their associated points that contributed to the point total for the team.
32+
* List of events and their associated points that contributed to the point total for the team.
3333
*/
3434
EventPoints[] event_points;
3535

src/main/java/com/thebluealliance/api/v3/models/EliminationAlliance.java

Lines changed: 12 additions & 12 deletions
Original file line numberDiff line numberDiff line change
@@ -9,27 +9,27 @@
99
public class EliminationAlliance {
1010

1111
/**
12-
* @return Alliance name, may be null.
12+
* Alliance name, may be null.
1313
*/
1414
String name;
1515

1616
/**
17-
* @return Backup team called in, may be null.
17+
* Backup team called in, may be null.
1818
*/
1919
AllianceBackup backup;
2020

2121
/**
22-
* @return List of team keys that declined the alliance.
22+
* List of team keys that declined the alliance.
2323
*/
2424
String[] declines;
2525

2626
/**
27-
* @return List of team keys picked for the alliance. First pick is captain.
27+
* List of team keys picked for the alliance. First pick is captain.
2828
*/
2929
String[] picks;
3030

3131
/**
32-
* @return A {@link PlayoffStatus} object with current statistics of the alliance.
32+
* A {@link PlayoffStatus} object with current statistics of the alliance.
3333
*/
3434
PlayoffStatus status;
3535

@@ -40,12 +40,12 @@ public class EliminationAlliance {
4040
public class AllianceBackup {
4141

4242
/**
43-
* @return Team key that was replaced by the backup team.
43+
* Team key that was replaced by the backup team.
4444
*/
4545
String out;
4646

4747
/**
48-
* @return Team key that was called in as the backup.
48+
* Team key that was called in as the backup.
4949
*/
5050
String in;
5151

@@ -58,27 +58,27 @@ public class AllianceBackup {
5858
public class PlayoffStatus {
5959

6060
/**
61-
* @return The level of the bracket that an alliance is currently in or was eliminated in. Value may be <code>qf</code>, <code>sf</code>, or <code>f</code>
61+
* The level of the bracket that an alliance is currently in or was eliminated in. Value may be <code>qf</code>, <code>sf</code>, or <code>f</code>
6262
*/
6363
String level;
6464

6565
/**
66-
* @return The current playing status of an alliance. Value may be <code>eliminated</code>, <code>won</code>, or <code>playing</code>.
66+
* The current playing status of an alliance. Value may be <code>eliminated</code>, <code>won</code>, or <code>playing</code>.
6767
*/
6868
String status;
6969

7070
/**
71-
* @return A {@link WLTRecord} for the alliance at the current level of the playoff tournament
71+
* A {@link WLTRecord} for the alliance at the current level of the playoff tournament
7272
*/
7373
WLTRecord current_level_record;
7474

7575
/**
76-
* @return A {@link WLTRecord} for the alliance during the entire playoff tournament
76+
* A {@link WLTRecord} for the alliance during the entire playoff tournament
7777
*/
7878
WLTRecord record;
7979

8080
/**
81-
* @return The average of all playoff matches of an alliance. May be <code>null</code>.
81+
* The average of all playoff matches of an alliance. May be <code>null</code>.
8282
*/
8383
double playoff_average;
8484

src/main/java/com/thebluealliance/api/v3/models/Event.java

Lines changed: 33 additions & 33 deletions
Original file line numberDiff line numberDiff line change
@@ -9,122 +9,122 @@
99
public class Event {
1010

1111
/**
12-
* @return A list of webcasts for the event
12+
* A list of webcasts for the event
1313
*/
1414
Webcast[] webcasts;
1515

1616
/**
17-
* @return Postal code from the event address.
17+
* Postal code from the event address.
1818
*/
1919
String postal_code;
2020
/**
21-
* @return The TBA Event key that represents the event's parent. Used to link back to the event from a division event. It is also the inverse relation of <code>divison_keys</code>.
21+
* The TBA Event key that represents the event's parent. Used to link back to the event from a division event. It is also the inverse relation of <code>divison_keys</code>.
2222
*/
2323
String parent_event_key;
2424
/**
25-
* @return Same as <code>name</code> but doesn�t include event specifiers, such as �Regional� or 'District�. May be null.
25+
* Same as <code>name</code> but doesn�t include event specifiers, such as �Regional� or 'District�. May be null.
2626
*/
2727
String short_name;
2828
/**
29-
* @return Link to address location on Google Maps.
29+
* Link to address location on Google Maps.
3030
*/
3131
String gmaps_url;
3232
/**
33-
* @return String representation of the <code>playoff_type</code>, or null.
33+
* String representation of the <code>playoff_type</code>, or null.
3434
*/
3535
String playoff_type_string;
3636
/**
37-
* @return Event Type, eg Regional, District, or Offseason.
37+
* Event Type, eg Regional, District, or Offseason.
3838
*/
3939
String event_type_string;
4040
/**
41-
* @return Google Maps Place ID for the event address.
41+
* Google Maps Place ID for the event address.
4242
*/
4343
String gmaps_place_id;
4444
/**
45-
* @return Address of the event�s venue, if available
45+
* Address of the event�s venue, if available
4646
*/
4747
String address;
4848
/**
49-
* @return Name of the location at the address for the event, eg. Blue Alliance High School.
49+
* Name of the location at the address for the event, eg. Blue Alliance High School.
5050
*/
5151
String location_name;
5252
/**
53-
* @return Timezone name.
53+
* Timezone name.
5454
*/
5555
String timezone;
5656
/**
57-
* @return The FIRST internal Event ID, used to link to the event on the FRC webpage.
57+
* The FIRST internal Event ID, used to link to the event on the FRC webpage.
5858
*/
5959
String first_event_id;
6060
/**
61-
* @return The event's website, if any.
61+
* The event's website, if any.
6262
*/
6363
String website;
6464

6565
/**
66-
* @return Latitude for the event address.
66+
* Latitude for the event address.
6767
*/
6868
double lat;
6969
/**
70-
* @return Longitude for the event address.
70+
* Longitude for the event address.
7171
*/
7272
double lng;
7373
/**
74-
* @return An array of event keys for the divisions at this event.
74+
* An array of event keys for the divisions at this event.
7575
*/
7676
String[] division_keys;
7777
/**
78-
* @return Week of the competition season this event is in.
78+
* Week of the competition season this event is in.
7979
*/
8080
int week;
8181
/**
82-
* @return Year the event data is for.
82+
* Year the event data is for.
8383
*/
8484
int year;
8585
/**
86-
* @return Playoff Type, as defined <a href="https://github.com/the-blue-alliance/the-blue-alliance/blob/master/consts/playoff_type.py#L4">here</a> , or null.
86+
* Playoff Type, as defined <a href="https://github.com/the-blue-alliance/the-blue-alliance/blob/master/consts/playoff_type.py#L4">here</a> , or null.
8787
*/
8888
int playoff_type;
8989
/**
90-
* @return Event Type, as defined <a href="https://github.com/the-blue-alliance/the-blue-alliance/blob/master/consts/event_type.py#L2">here</a>
90+
* Event Type, as defined <a href="https://github.com/the-blue-alliance/the-blue-alliance/blob/master/consts/event_type.py#L2">here</a>
9191
*/
9292
int event_type;
9393

9494
/**
95-
* @return City, town, village, etc. the event is located in.
95+
* City, town, village, etc. the event is located in.
9696
*/
9797
String city;
9898
/**
99-
* @return Event start date in <code>yyyy-mm-dd</code> format.
99+
* Event start date in <code>yyyy-mm-dd</code> format.
100100
*/
101101
String start_date;
102102
/**
103-
* @return Official name of event on record either provided by FIRST or organizers of offseason event.
103+
* Official name of event on record either provided by FIRST or organizers of offseason event.
104104
*/
105105
String name;
106106
/**
107-
* @return Event short code, as provided by FIRST.
107+
* Event short code, as provided by FIRST.
108108
*/
109109
String event_code;
110110
/**
111-
* @return Event end date in <code>yyyy-mm-dd</code> format.
111+
* Event end date in <code>yyyy-mm-dd</code> format.
112112
*/
113113
String end_date;
114114
/**
115-
* @return Country the event is located in.
115+
* Country the event is located in.
116116
*/
117117
String country;
118118
/**
119-
* @return State or Province the event is located in.
119+
* State or Province the event is located in.
120120
*/
121121
String state_prov;
122122
/**
123-
* @return TBA event key with the format yyyy[EVENT_CODE], where yyyy is the year, and EVENT_CODE is the event code of the event.
123+
* TBA event key with the format yyyy[EVENT_CODE], where yyyy is the year, and EVENT_CODE is the event code of the event.
124124
*/
125125
String key;
126126
/**
127-
* @return A {@link District} object representing the district the event is in. May be null.
127+
* A {@link District} object representing the district the event is in. May be null.
128128
*/
129129
District district;
130130

@@ -135,16 +135,16 @@ public class Event {
135135
public class Webcast {
136136

137137
/**
138-
* @return Type of webcast, typically descriptive of the streaming provider. Value may be <code>youtube</code>, <code>twitch</code>, <code>ustream</code>, <code>iframe</code>, <code>html5</code>,
139-
* <code>rtmp</code>, or <code>livestream</code>
138+
* Type of webcast, typically descriptive of the streaming provider. Value may be <code>youtube</code>, <code>twitch</code>, <code>ustream</code>, <code>iframe</code>, <code>html5</code>,
139+
* <code>rtmp</code>, or <code>livestream</code>
140140
*/
141141
String type;
142142
/**
143-
* @return Type specific channel information. May be the YouTube stream, or Twitch channel name. In the case of iframe types, contains HTML to embed the stream in an HTML iframe.
143+
* Type specific channel information. May be the YouTube stream, or Twitch channel name. In the case of iframe types, contains HTML to embed the stream in an HTML iframe.
144144
*/
145145
String channel;
146146
/**
147-
* @return File identification as may be required for some types. May be null.
147+
* File identification as may be required for some types. May be null.
148148
*/
149149
String file;
150150

src/main/java/com/thebluealliance/api/v3/models/EventDistrictPoints.java

Lines changed: 6 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -13,15 +13,17 @@ public class EventDistrictPoints {
1313
private HashMap<String, Tiebreaker> tiebreakers;
1414

1515
/**
16-
* @param teamNumber Team number used for a query
16+
* @param teamNumber
17+
* Team number used for a query
1718
* @return A {@link Tiebreaker} object for that team
1819
*/
1920
public Tiebreaker getTiebreaker(int teamNumber) {
2021
return tiebreakers.get("frc" + teamNumber);
2122
}
2223

2324
/**
24-
* @param teamNumber Team number used for a query
25+
* @param teamNumber
26+
* Team number used for a query
2527
* @return The {@link EventPoints} the team earned
2628
*/
2729
public EventPoints getEventPoints(int teamNumber) {
@@ -34,11 +36,11 @@ public EventPoints getEventPoints(int teamNumber) {
3436
@Value
3537
public class Tiebreaker {
3638
/**
37-
* @return Number of qualification match wins
39+
* Number of qualification match wins
3840
*/
3941
private int qual_wins;
4042
/**
41-
* @return List of three highest qualification match scores
43+
* List of three highest qualification match scores
4244
*/
4345
private int[] highest_qual_scores;
4446
}

0 commit comments

Comments
 (0)