Fix and complete JavaDoc comments

2026-05-06 16:59:18 +02:00
parent b40ed99bc1
commit 51718699a3
35 changed files with 390 additions and 54 deletions
@@ -119,6 +119,13 @@ public class GameController {
        return model.DrawLowerBuildingCardByIndex(model.getPlayerByUsername(playerUsername), pos);
    }

+    /**
+     * Skips the upper card drawing action for the specified player.
+     *
+     * @param playerUsername the username of the player who wants to skip the upper drawing action.
+     * @return {@code true} if the skip action is valid and successfully performed;
+     *         {@code false} if the player does not exist or the action is not valid.
+     */
    public boolean SkipUpperDrawing(String playerUsername) {
        Player player= model.getPlayerByUsername(playerUsername);
        if(player==null)
@@ -126,6 +133,13 @@ public class GameController {
        return model.SkipUpperDrawing(model.getPlayerByUsername(playerUsername));
    }

+    /**
+     * Skips the lower card drawing action for the specified player.
+     *
+     * @param playerUsername the username of the player who wants to skip the lower drawing action.
+     * @return {@code true} if the skip action is valid and successfully performed;
+     *         {@code false} if the player does not exist or the action is not valid.
+     */
    public boolean SkipLowerDrawing(String playerUsername) {
        Player player= model.getPlayerByUsername(playerUsername);
        if(player==null)