From faaf3397dab24bd13003a81195f08fa7b0060237 Mon Sep 17 00:00:00 2001
From: Hsu Still <341464@gmail.com>
Date: Wed, 21 Mar 2018 00:43:12 +0800
Subject: [PATCH] Add XMLDocs

+ EmbedBuilderExtensions
+ CacheMode
+ ImageFormat
---
 src/Discord.Net.Core/Entities/CacheMode.cs                | 4 +++-
 src/Discord.Net.Core/Entities/ImageFormat.cs              | 3 ++-
 src/Discord.Net.Core/Extensions/EmbedBuilderExtensions.cs | 7 +++++++
 3 files changed, 12 insertions(+), 2 deletions(-)

diff --git a/src/Discord.Net.Core/Entities/CacheMode.cs b/src/Discord.Net.Core/Entities/CacheMode.cs
index a047bd616..c4342eea2 100644
--- a/src/Discord.Net.Core/Entities/CacheMode.cs
+++ b/src/Discord.Net.Core/Entities/CacheMode.cs
@@ -1,8 +1,10 @@
-namespace Discord
+namespace Discord
 {
     public enum CacheMode
     {
+        /// <summary> Allows the object to be downloaded if it does not exist in the current cache. </summary>
         AllowDownload,
+        /// <summary> Only allows the object to be pulled from the existing cache. </summary>
         CacheOnly
     }
 }
diff --git a/src/Discord.Net.Core/Entities/ImageFormat.cs b/src/Discord.Net.Core/Entities/ImageFormat.cs
index 302da79c8..0b74a443e 100644
--- a/src/Discord.Net.Core/Entities/ImageFormat.cs
+++ b/src/Discord.Net.Core/Entities/ImageFormat.cs
@@ -1,5 +1,6 @@
-namespace Discord
+namespace Discord
 {
+    /// <summary> The type of format for the image to return. </summary>
     public enum ImageFormat
     {
         Auto,
diff --git a/src/Discord.Net.Core/Extensions/EmbedBuilderExtensions.cs b/src/Discord.Net.Core/Extensions/EmbedBuilderExtensions.cs
index 2eb4ed473..5ad8d8b1d 100644
--- a/src/Discord.Net.Core/Extensions/EmbedBuilderExtensions.cs
+++ b/src/Discord.Net.Core/Extensions/EmbedBuilderExtensions.cs
@@ -4,24 +4,31 @@ namespace Discord
 {
     public static class EmbedBuilderExtensions
     {
+        /// <summary> Adds embed color based on the provided raw value. </summary>
         public static EmbedBuilder WithColor(this EmbedBuilder builder, uint rawValue) =>
             builder.WithColor(new Color(rawValue));
 
+        /// <summary> Adds embed color based on the provided RGB <see cref="byte"/> value. </summary>
         public static EmbedBuilder WithColor(this EmbedBuilder builder, byte r, byte g, byte b) =>
             builder.WithColor(new Color(r, g, b));
 
+        /// <summary> Adds embed color based on the provided RGB <see cref="int"/> value. </summary>
         public static EmbedBuilder WithColor(this EmbedBuilder builder, int r, int g, int b) =>
             builder.WithColor(new Color(r, g, b));
 
+        /// <summary> Adds embed color based on the provided RGB <see cref="float"/> value. </summary>
         public static EmbedBuilder WithColor(this EmbedBuilder builder, float r, float g, float b) =>
             builder.WithColor(new Color(r, g, b));
 
+        /// <summary> Fills the embed author field with the provided user's full username and avatar URL. </summary>
         public static EmbedBuilder WithAuthor(this EmbedBuilder builder, IUser user) =>
             builder.WithAuthor($"{user.Username}#{user.Discriminator}", user.GetAvatarUrl());
 
+        /// <summary> Fills the embed author field with the provided user's nickname and avatar URL; username is used if nickname is not set. </summary>
         public static EmbedBuilder WithAuthor(this EmbedBuilder builder, IGuildUser user) =>
             builder.WithAuthor($"{user.Nickname ?? user.Username}#{user.Discriminator}", user.GetAvatarUrl());
 
+        /// <summary> Converts a <see cref="EmbedType.Rich"/> <see cref="IEmbed"/> object to a <see cref="EmbedBuilder"/>. </summary>
         public static EmbedBuilder ToEmbedBuilder(this IEmbed embed)
         {
             if (embed.Type != EmbedType.Rich)