docs(network): fix some wordings

Author: xeruf

sdk/src/server-api/sc/networking/clients/XStreamClient.java

@@ -223,12 +223,12 @@ public DisconnectCause getDisconnectCause() {
   }
 
   /**
-   * Should be called when the client needs to be stopped and the disconnect
-   * is initiated on this side. There are two situations where this should be
-   * done:
+   * Should be called when the client needs to be stopped
+   * and the disconnect is initiated on this side.
+   * There are two situations where this should be done:
    * <p>
    * - A game has ended
-   * - An internal error occurred (this situation might be redundant)
+   * - An error occurred
    */
   public void stop() {
     // this side caused disconnect, notify other side

server/src/sc/server/gaming/GameRoom.java

@@ -261,11 +261,9 @@ private void startIfReady() {
     start();
   }
 
-  /** If the Game is prepared, sync all slots. */
   private synchronized void start() {
     setStatus(GameStatus.ACTIVE);
     this.game.start();
-
     logger.info("Started {}", game);
   }
 
@@ -441,10 +439,7 @@ public boolean isOver() {
     return getStatus() == GameStatus.OVER;
   }
 
-  /**
-   * Return whether or not the game is paused or will be paused in the next turn.
-   * Refer to {@link AbstractGame#isPaused()} for the current value.
-   */
+  /** Return whether or not the game is paused or will be paused in the next turn. */
   public boolean isPauseRequested() {
     return this.pauseRequested;
   }

server/src/sc/server/network/Client.java

@@ -21,7 +21,7 @@
 import java.util.List;
 
 /**
- * A generic client. This represents a client in the server.
+ * Represents a client in the server.
  *
  * Clients which connect to the server (as separate programs or running as threads started by the server)
  * are represented by {@link sc.networking.clients.LobbyClient}.