Doc waiting list game list

src/Library/GameList.cs

@@ -1,17 +1,48 @@
 namespace Library;
-
+/// <summary>
+/// Esta clase representa la lista de partidas en curso.
+/// </summary>
 public class GameList
 {
+    /// <summary>
+    /// Obtiene la lista de partidas.
+    /// </summary>
     private List<Game> Games { get; set; } = new List<Game>();
 
+    /// <summary>
+    /// Agrega una partida a la lista de partidas.
+    /// </summary>
+    /// <param name="player1"></param>
+    /// <param name="player2"></param>
+    /// <returns>La partida agregada.</returns>
     public Game AddGame(Player player1, Player player2)
     {
         Game game = new Game(player1, player2);
         this.Games.Add(game);
         return game;
     }
+    /// <summary>
+    /// Elimina una partida de la lista de partidas.
+    /// </summary>
+    /// <param name="game"></param>
+    /// <returns>
+    /// <c>true</c> si la partida fue eliminada. <c>false</c> si no encontró la partida.
+    /// </returns>
+    public bool RemoveGame(Game game)
+    {
+        if (this.Games.Remove(game))
+            return true;
+        return false;
+    }
 
+    /// <summary>
+    /// Devuelve un jugador buscandolo por su nombre
+    /// </summary>
+    /// <param name="playerName"></param>
+    /// <returns>
+    /// <c>null</c> si el jugador no está en ninguna partida.
+    /// </returns>
     public Player? FindPlayerByName(string playerName)
     {
         foreach (Game game in this.Games)
             foreach (Player player in game.GetPlayers())
@@ -20,7 +51,14 @@
         return null;
     }
 
+    /// <summary>
+    /// Devuelve la partida en la que se encuentra un jugador.
+    /// </summary>
+    /// <param name="player"></param>
+    /// <returns>
+    /// <c>null</c> si el jugador no está en ninguna partida.
+    /// </returns>
     public Game? FindGameByPlayer(Player player)
     {
         foreach (Game game in this.Games)
             if (game.GetPlayers().Contains(player))

src/Library/WaitingList.cs

@@ -1,14 +1,31 @@
 namespace Library;
-
+/// <summary>
+/// Esta clase representa la lista de espera.
+/// </summary>
 public class WaitingList
 {
+    /// <summary>
+    /// Obtiene la lista de jugadores en espera.
+    /// </summary>
+
     private List<Player> Players { get; set; }= new List<Player>();
 
+    /// <summary>
+    /// Devuelve el número de jugadores en espera.
+    /// </summary>
     public int Count
     {
         get { return this.Players.Count; }
     }
 
+    /// <summary>
+    /// Agrega un jugador a la lista de espera.
+    /// </summary>
+    /// <param name="playerName"></param>
+    /// <returns>
+    ///<c>true</c> si el jugador fue agregado. <c>false</c> si ya estaba esperando.
+    /// </returns>
+    /// <exception cref="ArgumentException"></exception>
     public bool AddPlayer(string playerName)
     {
         if (string.IsNullOrEmpty(playerName))
@@ -18,17 +35,31 @@
         this.Players.Add(new Player(playerName));
         return true;
     }
-
+
+    /// <summary>
+    /// Elimina un jugador de la lista de espera.
+    /// </summary>
+    /// <param name="playerName"></param>
+    /// <returns>
+    ///<c>true</c> si el jugador fue eliminado. <c>false</c> si no estaba esperando.
+    /// </returns>
     public bool RemovePlayer(string playerName)
     {
         Player? player = FindPlayerByName(playerName);
         if (player == null)
             return false;
         this.Players.Remove(player);
         return true;
     }
 
+    /// <summary>
+    /// Devuelve un jugador de la lista de espera buscandolo por su nombre.
+    /// </summary>
+    /// <param name="playerName"></param>
+    /// <returns>
+    /// <c>null</c> si el jugador no está esperando.
+    /// </returns>
     public Player? FindPlayerByName(string playerName)
     {
         foreach (Player player in this.Players)
             if (player.Name == playerName)
@@ -36,7 +67,10 @@
         return null;
     }
 
+    /// <summary>
+    /// Devuelve un jugador al azar de la lista de espera.
+    /// </summary>
     public Player? GetAnyoneWaiting()
     {
         Random random = new Random();
         int randomNumber = random.Next(0, this.Count);