moar updates

Author: Gonkers

src/ScryfallApi.Client/Apis/Cards.cs

@@ -14,6 +14,7 @@ internal Cards(BaseRestService restService)
         _restService = restService;
     }
 
+#pragma warning disable CS1591 // Missing XML comment for publicly visible type or member
     public Task<ResultList<Card>> Get(int page) => _restService.GetAsync<ResultList<Card>>($"/cards?page={page}");
 
     public Task<Card> GetRandom() => _restService.GetAsync<Card>($"/cards/random", false);
@@ -28,4 +29,5 @@ public Task<ResultList<Card>> Search(string query, int page, SearchOptions optio
         query = WebUtility.UrlEncode(query);
         return _restService.GetAsync<ResultList<Card>>($"/cards/search?q={query}&page={page}&{options.BuildQueryString()}");
     }
+#pragma warning restore CS1591 // Missing XML comment for publicly visible type or member
 }

src/ScryfallApi.Client/Apis/ICards.cs

@@ -9,8 +9,34 @@ namespace ScryfallApi.Client.Apis;
 /// </summary>
 public interface ICards
 {
+    /// <summary>
+    /// Fetch a card at random.
+    /// </summary>
+    /// <returns></returns>
     Task<Card> GetRandom();
+
+    /// <summary>
+    /// Get a page worth of cards
+    /// </summary>
+    /// <param name="page"></param>
+    /// <returns></returns>
     Task<ResultList<Card>> Get(int page);
+
+    /// <summary>
+    /// Search for cards with a sort option
+    /// </summary>
+    /// <param name="query"></param>
+    /// <param name="page"></param>
+    /// <param name="sort"></param>
+    /// <returns></returns>
     Task<ResultList<Card>> Search(string query, int page, CardSort sort);
+    
+    /// <summary>
+    /// Search for cards using the full search options available
+    /// </summary>
+    /// <param name="query"></param>
+    /// <param name="page"></param>
+    /// <param name="options"></param>
+    /// <returns></returns>
     Task<ResultList<Card>> Search(string query, int page, SearchOptions options);
 }

src/ScryfallApi.Client/Models/Card.cs

@@ -266,7 +266,7 @@ public class Card : BaseItem
     /// </summary>
     [JsonPropertyName("uri")]
     public Uri Uri { get; set; }
-#endregion Gameplay Fields
+
     [JsonPropertyName("watermark")]
     public string Watermark { get; set; }
     public override string ToString() => Name +