diff --git a/src/main/java/org/example/scoreboard/api/IScoreboard.java b/src/main/java/org/example/scoreboard/api/IScoreboard.java
index 1abe65743a8c0021f7149d184a967986fe866ebf..b92e9ef5a14cc93b7b24ca00cbdceba6009c782e 100644
--- a/src/main/java/org/example/scoreboard/api/IScoreboard.java
+++ b/src/main/java/org/example/scoreboard/api/IScoreboard.java
@@ -29,9 +29,9 @@ public interface IScoreboard {
    * Update team scores.
    * Receiving the pair score; home team score and away team score updates a game score.
    *
-   * @param match
-   * @param homeTeamScore
-   * @param awayTeamScore
+   * @param match match to update
+   * @param homeTeamScore home team score
+   * @param awayTeamScore away team score
    * @return updated match
    */
   IMatch updateScore(IMatch match, IScore homeTeamScore, IScore awayTeamScore);
@@ -40,7 +40,7 @@ public interface IScoreboard {
    * Get a summary of games by total score.
    * Those games with the same total score will be returned ordered by the most recently added to our system.
    *
-   * @return
+   * @return ordered game summary
    */
   ArrayList<IMatch> getGameSummary();