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
{
+ /// Allows the object to be downloaded if it does not exist in the current cache.
AllowDownload,
+ /// Only allows the object to be pulled from the existing cache.
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
{
+ /// The type of format for the image to return.
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
{
+ /// Adds embed color based on the provided raw value.
public static EmbedBuilder WithColor(this EmbedBuilder builder, uint rawValue) =>
builder.WithColor(new Color(rawValue));
+ /// Adds embed color based on the provided RGB value.
public static EmbedBuilder WithColor(this EmbedBuilder builder, byte r, byte g, byte b) =>
builder.WithColor(new Color(r, g, b));
+ /// Adds embed color based on the provided RGB value.
public static EmbedBuilder WithColor(this EmbedBuilder builder, int r, int g, int b) =>
builder.WithColor(new Color(r, g, b));
+ /// Adds embed color based on the provided RGB value.
public static EmbedBuilder WithColor(this EmbedBuilder builder, float r, float g, float b) =>
builder.WithColor(new Color(r, g, b));
+ /// Fills the embed author field with the provided user's full username and avatar URL.
public static EmbedBuilder WithAuthor(this EmbedBuilder builder, IUser user) =>
builder.WithAuthor($"{user.Username}#{user.Discriminator}", user.GetAvatarUrl());
+ /// Fills the embed author field with the provided user's nickname and avatar URL; username is used if nickname is not set.
public static EmbedBuilder WithAuthor(this EmbedBuilder builder, IGuildUser user) =>
builder.WithAuthor($"{user.Nickname ?? user.Username}#{user.Discriminator}", user.GetAvatarUrl());
+ /// Converts a object to a .
public static EmbedBuilder ToEmbedBuilder(this IEmbed embed)
{
if (embed.Type != EmbedType.Rich)