fill missing IScoreboard javadoc

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();