From f40d1a1e81b6e463dac52e4c342d154efce873cd Mon Sep 17 00:00:00 2001
From: unknown <mateo.gutierrezo@correo.ucu.edu.uy>
Date: Thu, 7 Nov 2024 14:40:43 -0300
Subject: [PATCH 1/2] primera documentacion

---
 src/Library/WaitingList.cs | 18 +++++++++++++++++-
 1 file changed, 17 insertions(+), 1 deletion(-)

diff --git a/src/Library/WaitingList.cs b/src/Library/WaitingList.cs
index 67b5a4b..1c25f2e 100644
--- a/src/Library/WaitingList.cs
+++ b/src/Library/WaitingList.cs
@@ -1,14 +1,30 @@
 namespace Library;
-
+/// <summary>
+/// Esta clase representa la lista de espera.
+/// </summary>
 public class WaitingList
 {
+    /// <summary>
+    /// Obtiene la lista de jugadores en espera.
+    /// </summary>
     public List<Player> Players { get; private 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))

From b2bda216c601d226375002fbcf8909c0c76b7054 Mon Sep 17 00:00:00 2001
From: unknown <mateo.gutierrezo@correo.ucu.edu.uy>
Date: Thu, 7 Nov 2024 16:36:44 -0300
Subject: [PATCH 2/2] documentacion waitingList GameList

---
 src/Library/GameList.cs    | 40 +++++++++++++++++++++++++++++++++++++-
 src/Library/WaitingList.cs | 19 +++++++++++++++++-
 2 files changed, 57 insertions(+), 2 deletions(-)

diff --git a/src/Library/GameList.cs b/src/Library/GameList.cs
index 07636ab..865c5d2 100644
--- a/src/Library/GameList.cs
+++ b/src/Library/GameList.cs
@@ -1,16 +1,47 @@
 namespace Library;
-
+/// <summary>
+/// Esta clase representa la lista de partidas en curso.
+/// </summary>
 public class GameList
 {
+    /// <summary>
+    /// Obtiene la lista de partidas.
+    /// </summary>
     public List<Game> Games { get; private 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)
@@ -20,6 +51,13 @@ public Game AddGame(Player player1, Player player2)
         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)
diff --git a/src/Library/WaitingList.cs b/src/Library/WaitingList.cs
index 1c25f2e..999ef71 100644
--- a/src/Library/WaitingList.cs
+++ b/src/Library/WaitingList.cs
@@ -34,7 +34,14 @@ public bool AddPlayer(string playerName)
         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);
@@ -44,6 +51,13 @@ public bool RemovePlayer(string playerName)
         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)
@@ -52,6 +66,9 @@ public bool RemovePlayer(string playerName)
         return null;
     }
     
+    /// <summary>
+    /// Devuelve un jugador al azar de la lista de espera.
+    /// </summary>
     public Player? GetAnyoneWaiting()
     {
         Random random = new Random();