[chore] Add missing docstrings (#522)

Author: nwithan8

EasyPost/Hooks.cs

@@ -1,11 +1,14 @@
 using System;
-using System.Collections.Generic;
 using System.Net;
 using System.Net.Http;
 using System.Net.Http.Headers;
+using EasyPost._base;
 
 namespace EasyPost;
 
+/// <summary>
+///     Class representing a set of callbacks to use for introspecting API requests made by an <see cref="EasyPostClient"/>.
+/// </summary>
 public class Hooks
 {
     /// <summary>
@@ -20,6 +23,10 @@ public class Hooks
     public EventHandler<OnRequestResponseReceivedEventArgs>? OnRequestResponseReceived { get; set; }
 }
 
+/// <summary>
+///     Represents a set of <see cref="EventArgs"/> containing information about an in-flight HTTP request.
+///     This set is passed into the <see cref="Hooks.OnRequestExecuting"/> event handler.
+/// </summary>
 public class OnRequestExecutingEventArgs : EventArgs
 {
     /// <summary>
@@ -71,6 +78,10 @@ internal OnRequestExecutingEventArgs(HttpRequestMessage request, int timestamp,
     }
 }
 
+/// <summary>
+///     Represents a set of <see cref="EventArgs"/> containing information about an HTTP response received by the client.
+///     This set is passed into the <see cref="Hooks.OnRequestResponseReceived"/> event handler.
+/// </summary>
 public class OnRequestResponseReceivedEventArgs : EventArgs
 {
     /// <summary>

EasyPost/Models/API/CarrierAccountType.cs

@@ -3,18 +3,44 @@
 
 namespace EasyPost.Models.API;
 
+/// <summary>
+///     Enums representing specific carrier account types.
+/// </summary>
 public class CarrierAccountType : ValueEnum
 {
+    /// <summary>
+    ///     Represents a FedEx carrier account.
+    /// </summary>
     public static readonly CarrierAccountType FedEx = new CarrierAccountType(26, "FedexAccount");
+
+    /// <summary>
+    ///     Represents a FedEx SmartPost carrier account.
+    /// </summary>
     public static readonly CarrierAccountType FedExSmartPost = new CarrierAccountType(30, "FedexSmartpostAccount");
+
+    /// <summary>
+    ///     Represents a UPS carrier account.
+    /// </summary>
     public static readonly CarrierAccountType Ups = new CarrierAccountType(59, "UpsAccount");
 
+    /// <summary>
+    ///     Constructor for CarrierAccountType enum.
+    /// </summary>
+    /// <param name="id">Internal ID of the enum. Must be unique among all enums of this specific type.</param>
+    /// <param name="name">Name of the carrier account type. Stored as the value associated with this enum.</param>
     private CarrierAccountType(int id, string name)
         : base(id, name)
     {
     }
 
+    /// <summary>
+    ///     Gets the name of this <see cref="CarrierAccountType"/>.
+    /// </summary>
     public string Name => (string)Value;
 
+    /// <summary>
+    ///     Gets all <see cref="CarrierAccountType"/> enums.
+    /// </summary>
+    /// <returns></returns>
     public static IEnumerable<CarrierAccountType> All() => GetAll<CarrierAccountType>();
 }

EasyPost/Parameters/BaseParameters.cs

@@ -231,10 +231,12 @@ private void Add(RequestParameterAttribute requestParameterAttribute, object? va
             // Get the key and update the list of keys
             string key = keys[0];
             keys = keys.Skip(1).ToArray();
+#pragma warning disable CA1854 // Don't want to use TryGetValue because no need for value
             if (!dictionary.ContainsKey(key))
             {
                 dictionary[key] = UpdateDictionary(new Dictionary<string, object?>(), keys, value);
             }
+#pragma warning restore CA1854
 
             object? subDirectory = dictionary[key];
             if (subDirectory is Dictionary<string, object?> subDictionary)

EasyPost/Parameters/IBaseParameters.cs

@@ -12,10 +12,22 @@
 
 namespace EasyPost.Parameters
 {
+    /// <summary>
+    ///     Base interface for all EasyPost API parameters.
+    /// </summary>
     public interface IBaseParameters
     {
+        /// <summary>
+        ///     Convert this object to a <see cref="Dictionary{TKey,TValue}"/>.
+        /// </summary>
+        /// <returns></returns>
         public Dictionary<string, object> ToDictionary();
 
+        /// <summary>
+        ///     Convert this object to a sub-<see cref="Dictionary{TKey,TValue}"/> based on the parent parameter object type.
+        /// </summary>
+        /// <param name="parentParameterObjectType"></param>
+        /// <returns></returns>
         public Dictionary<string, object> ToSubDictionary(Type parentParameterObjectType);
     }
 }