From e85fca6b45729c8ff64c30c8c91c50e57891f98a Mon Sep 17 00:00:00 2001 From: sarcasmloading <29299928+sarcasmloading@users.noreply.github.com> Date: Wed, 11 Jul 2018 21:42:13 +1200 Subject: [PATCH 1/9] Added documentation for many audit log data types, fixed vowel indefinite articles --- .../DataTypes/ChannelCreateAuditLogData.cs | 2 +- .../DataTypes/ChannelDeleteAuditLogData.cs | 2 +- .../DataTypes/ChannelUpdateAuditLogData.cs | 14 ++++++++++++- .../DataTypes/EmoteCreateAuditLogData.cs | 2 +- .../DataTypes/EmoteDeleteAuditLogData.cs | 2 +- .../DataTypes/EmoteUpdateAuditLogData.cs | 2 +- .../Entities/AuditLogs/DataTypes/GuildInfo.cs | 2 +- .../DataTypes/InviteCreateAuditLogData.cs | 2 +- .../DataTypes/InviteDeleteAuditLogData.cs | 2 +- .../AuditLogs/DataTypes/InviteInfo.cs | 2 +- .../DataTypes/InviteUpdateAuditLogData.cs | 15 +++++++++++++ .../AuditLogs/DataTypes/KickAuditLogData.cs | 9 ++++++++ .../DataTypes/MemberRoleAuditLogData.cs | 15 +++++++++++++ .../AuditLogs/DataTypes/MemberRoleEditInfo.cs | 21 +++++++++++++++++++ 14 files changed, 82 insertions(+), 10 deletions(-) diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelCreateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelCreateAuditLogData.cs index ffd620e04..ce3a96041 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelCreateAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelCreateAuditLogData.cs @@ -50,7 +50,7 @@ namespace Discord.Rest /// Gets the snowflake ID of the created channel. /// /// - /// An representing the snowflake identifier for the created channel. + /// A representing the snowflake identifier for the created channel. /// public ulong ChannelId { get; } /// diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelDeleteAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelDeleteAuditLogData.cs index c56bf6d32..f16a79475 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelDeleteAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelDeleteAuditLogData.cs @@ -41,7 +41,7 @@ namespace Discord.Rest /// Gets the snowflake ID of the deleted channel. /// /// - /// An representing the snowflake identifier for the deleted channel. + /// A representing the snowflake identifier for the deleted channel. /// public ulong ChannelId { get; } /// diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelUpdateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelUpdateAuditLogData.cs index 7cad9eff7..0ab39aba8 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelUpdateAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelUpdateAuditLogData.cs @@ -45,10 +45,22 @@ namespace Discord.Rest /// Gets the snowflake ID of the updated channel. /// /// - /// An representing the snowflake identifier for the updated channel. + /// A representing the snowflake identifier for the updated channel. /// public ulong ChannelId { get; } + /// + /// Gets the channel information before the changes. + /// + /// + /// An information object containing the original channel information before the changes were made. + /// public ChannelInfo Before { get; } + /// + /// Gets the channel information after the changes. + /// + /// + /// An information object containing the channel information after the changes were made. + /// public ChannelInfo After { get; } } } diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteCreateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteCreateAuditLogData.cs index a114548cc..99d7ff24a 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteCreateAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteCreateAuditLogData.cs @@ -28,7 +28,7 @@ namespace Discord.Rest /// Gets the snowflake ID of the created emoji. /// /// - /// An representing the snowflake identifier for the created emoji. + /// A representing the snowflake identifier for the created emoji. /// public ulong EmoteId { get; } /// diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteDeleteAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteDeleteAuditLogData.cs index e522b0ee2..ec74e3aef 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteDeleteAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteDeleteAuditLogData.cs @@ -29,7 +29,7 @@ namespace Discord.Rest /// Gets the snowflake ID of the deleted emoji. /// /// - /// An representing the snowflake identifier for the deleted emoji. + /// A representing the snowflake identifier for the deleted emoji. /// public ulong EmoteId { get; } /// diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteUpdateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteUpdateAuditLogData.cs index e8cd76513..de6550039 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteUpdateAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteUpdateAuditLogData.cs @@ -31,7 +31,7 @@ namespace Discord.Rest /// Gets the snowflake ID of the updated emoji. /// /// - /// An representing the snowflake identifier of the updated emoji. + /// A representing the snowflake identifier of the updated emoji. /// public ulong EmoteId { get; } /// diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/GuildInfo.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/GuildInfo.cs index 494aac133..df63251d8 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/GuildInfo.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/GuildInfo.cs @@ -38,7 +38,7 @@ namespace Discord.Rest /// Gets the ID of the AFK voice channel for this guild. /// /// - /// An representing the snowflake identifier of the AFK voice channel; null if + /// A representing the snowflake identifier of the AFK voice channel; null if /// none is set. /// public ulong? AfkChannelId { get; } diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteCreateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteCreateAuditLogData.cs index df95d13b6..2da5abc24 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteCreateAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteCreateAuditLogData.cs @@ -81,7 +81,7 @@ namespace Discord.Rest /// Gets the ID of the channel this invite is linked to. /// /// - /// An representing the channel snowflake identifier that the invite points to. + /// A representing the channel snowflake identifier that the invite points to. /// public ulong ChannelId { get; } /// diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteDeleteAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteDeleteAuditLogData.cs index 472f227c0..f585ada34 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteDeleteAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteDeleteAuditLogData.cs @@ -81,7 +81,7 @@ namespace Discord.Rest /// Gets the ID of the channel this invite is linked to. /// /// - /// An representing the channel snowflake identifier that the invite points to. + /// A representing the channel snowflake identifier that the invite points to. /// public ulong ChannelId { get; } /// diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteInfo.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteInfo.cs index 54026dbf3..35f8937c2 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteInfo.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteInfo.cs @@ -42,7 +42,7 @@ namespace Discord.Rest /// Gets the ID of the channel this invite is linked to. /// /// - /// An representing the channel snowflake identifier that the invite points to; + /// A representing the channel snowflake identifier that the invite points to; /// null if not specified. /// public ulong? ChannelId { get; } diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteUpdateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteUpdateAuditLogData.cs index b932cfbfc..b0ffaa03a 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteUpdateAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteUpdateAuditLogData.cs @@ -5,6 +5,9 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { + /// + /// Represents a piece of audit log data relating to an invite update. + /// public class InviteUpdateAuditLogData : IAuditLogData { private InviteUpdateAuditLogData(InviteInfo before, InviteInfo after) @@ -40,7 +43,19 @@ namespace Discord.Rest return new InviteUpdateAuditLogData(before, after); } + /// + /// Gets the invite information before the changes. + /// + /// + /// An information object containing the original invite information before the changes were made. + /// public InviteInfo Before { get; } + /// + /// Gets the invite information after the changes. + /// + /// + /// An information object containing the invite information after the changes were made. + /// public InviteInfo After { get; } } } diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/KickAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/KickAuditLogData.cs index 41b5526b8..605ce604a 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/KickAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/KickAuditLogData.cs @@ -5,6 +5,9 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { + /// + /// Represents a piece of audit log data related to a kick. + /// public class KickAuditLogData : IAuditLogData { private KickAuditLogData(RestUser user) @@ -18,6 +21,12 @@ namespace Discord.Rest return new KickAuditLogData(RestUser.Create(discord, userInfo)); } + /// + /// Gets the user that was kicked. + /// + /// + /// A user object representing the kicked user. + /// public IUser Target { get; } } } diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberRoleAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberRoleAuditLogData.cs index 0d9a2a708..c6f036232 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberRoleAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberRoleAuditLogData.cs @@ -6,6 +6,9 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { + /// + /// A piece of audit log data related to a change in a guild member's roles. + /// public class MemberRoleAuditLogData : IAuditLogData { private MemberRoleAuditLogData(IReadOnlyCollection roles, IUser target) @@ -29,7 +32,19 @@ namespace Discord.Rest return new MemberRoleAuditLogData(roleInfos.ToReadOnlyCollection(), user); } + /// + /// Gets a collection of role changes that were performed on the member. + /// + /// + /// A read-only collection of . + /// public IReadOnlyCollection Roles { get; } + /// + /// Gets the user that the roles changes were performed on. + /// + /// + /// A user object representing the user that the role changes were performed on. + /// public IUser Target { get; } } } diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberRoleEditInfo.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberRoleEditInfo.cs index 4838b75c9..953d15bb1 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberRoleEditInfo.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberRoleEditInfo.cs @@ -1,5 +1,8 @@ namespace Discord.Rest { + /// + /// An information object representing a change in one of a member's roles. + /// public struct MemberRoleEditInfo { internal MemberRoleEditInfo(string name, ulong roleId, bool added) @@ -9,8 +12,26 @@ namespace Discord.Rest Added = added; } + /// + /// Gets the name of the role that was changed. + /// + /// + /// A string containing the name of the role that was changed. + /// public string Name { get; } + /// + /// Gets the ID of the role that was changed. + /// + /// + /// A representing the snowflake identifier of the role that was changed. + /// public ulong RoleId { get; } + /// + /// Determines whether the role was added to the user. + /// + /// + /// true if the role was added to the user; otherwise false. + /// public bool Added { get; } } } From 060bf1fc917e87c73d21cf6b670a9563a9cbd04d Mon Sep 17 00:00:00 2001 From: sarcasmloading <29299928+sarcasmloading@users.noreply.github.com> Date: Wed, 11 Jul 2018 21:53:53 +1200 Subject: [PATCH 2/9] Change audit log data types to start with 'Contains' (verb) instead of an article --- .../Entities/AuditLogs/DataTypes/BanAuditLogData.cs | 2 +- .../Entities/AuditLogs/DataTypes/ChannelCreateAuditLogData.cs | 2 +- .../Entities/AuditLogs/DataTypes/ChannelDeleteAuditLogData.cs | 2 +- .../Entities/AuditLogs/DataTypes/ChannelUpdateAuditLogData.cs | 2 +- .../Entities/AuditLogs/DataTypes/EmoteCreateAuditLogData.cs | 2 +- .../Entities/AuditLogs/DataTypes/EmoteDeleteAuditLogData.cs | 2 +- .../Entities/AuditLogs/DataTypes/EmoteUpdateAuditLogData.cs | 2 +- .../Entities/AuditLogs/DataTypes/GuildUpdateAuditLogData.cs | 2 +- .../Entities/AuditLogs/DataTypes/InviteCreateAuditLogData.cs | 2 +- .../Entities/AuditLogs/DataTypes/InviteDeleteAuditLogData.cs | 2 +- .../Entities/AuditLogs/DataTypes/InviteUpdateAuditLogData.cs | 2 +- .../Entities/AuditLogs/DataTypes/KickAuditLogData.cs | 2 +- .../Entities/AuditLogs/DataTypes/MemberRoleAuditLogData.cs | 4 ++-- .../Entities/AuditLogs/DataTypes/MemberRoleEditInfo.cs | 2 +- .../Entities/AuditLogs/DataTypes/MemberUpdateAuditLogData.cs | 3 +++ 15 files changed, 18 insertions(+), 15 deletions(-) diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/BanAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/BanAuditLogData.cs index 2e5331d59..113b52232 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/BanAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/BanAuditLogData.cs @@ -6,7 +6,7 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { /// - /// Represents a piece of audit log data related to a ban. + /// Contains audit log data related to a ban. /// public class BanAuditLogData : IAuditLogData { diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelCreateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelCreateAuditLogData.cs index ce3a96041..d9b6f2ed5 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelCreateAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelCreateAuditLogData.cs @@ -7,7 +7,7 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { /// - /// Represents a piece of audit log data related to a channel creation. + /// Contains audit log data related to a channel creation. /// public class ChannelCreateAuditLogData : IAuditLogData { diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelDeleteAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelDeleteAuditLogData.cs index f16a79475..dedcc90db 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelDeleteAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelDeleteAuditLogData.cs @@ -7,7 +7,7 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { /// - /// Represents a piece of audit log data related to a channel deletion. + /// Contains audit log data related to a channel deletion. /// public class ChannelDeleteAuditLogData : IAuditLogData { diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelUpdateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelUpdateAuditLogData.cs index 0ab39aba8..eb3f95381 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelUpdateAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelUpdateAuditLogData.cs @@ -6,7 +6,7 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { /// - /// Represents a piece of audit log data related to a channel update. + /// Contains audit log data related to a channel update. /// public class ChannelUpdateAuditLogData : IAuditLogData { diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteCreateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteCreateAuditLogData.cs index 99d7ff24a..ec7264c72 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteCreateAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteCreateAuditLogData.cs @@ -6,7 +6,7 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { /// - /// Represents a piece of audit log data related to an emoji creation. + /// Contains audit log data related to an emoji creation. /// public class EmoteCreateAuditLogData : IAuditLogData { diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteDeleteAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteDeleteAuditLogData.cs index ec74e3aef..dd256fbab 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteDeleteAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteDeleteAuditLogData.cs @@ -6,7 +6,7 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { /// - /// Represents a piece of audit log data related to an emoji deletion. + /// Contains audit log data related to an emoji deletion. /// public class EmoteDeleteAuditLogData : IAuditLogData { diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteUpdateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteUpdateAuditLogData.cs index de6550039..f1882df2c 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteUpdateAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteUpdateAuditLogData.cs @@ -6,7 +6,7 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { /// - /// Represents a piece of audit log data related to an emoji update. + /// Contains audit log data related to an emoji update. /// public class EmoteUpdateAuditLogData : IAuditLogData { diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/GuildUpdateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/GuildUpdateAuditLogData.cs index b4ffd3bf1..fcc2c7920 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/GuildUpdateAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/GuildUpdateAuditLogData.cs @@ -6,7 +6,7 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { /// - /// Represents a piece of audit log data related to a guild update. + /// Contains audit log data related to a guild update. /// public class GuildUpdateAuditLogData : IAuditLogData { diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteCreateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteCreateAuditLogData.cs index 2da5abc24..1d0bc1793 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteCreateAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteCreateAuditLogData.cs @@ -6,7 +6,7 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { /// - /// Represents a piece of audit log data related to an invite creation. + /// Contains audit log data related to an invite creation. /// public class InviteCreateAuditLogData : IAuditLogData { diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteDeleteAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteDeleteAuditLogData.cs index f585ada34..4471f07ca 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteDeleteAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteDeleteAuditLogData.cs @@ -6,7 +6,7 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { /// - /// Represents a piece of audit log data related to an invite removal. + /// Contains audit log data related to an invite removal. /// public class InviteDeleteAuditLogData : IAuditLogData { diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteUpdateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteUpdateAuditLogData.cs index b0ffaa03a..3ecf15548 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteUpdateAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteUpdateAuditLogData.cs @@ -6,7 +6,7 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { /// - /// Represents a piece of audit log data relating to an invite update. + /// Contains audit log data relating to an invite update. /// public class InviteUpdateAuditLogData : IAuditLogData { diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/KickAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/KickAuditLogData.cs index 605ce604a..b00f352a2 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/KickAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/KickAuditLogData.cs @@ -6,7 +6,7 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { /// - /// Represents a piece of audit log data related to a kick. + /// Contains audit log data related to a kick. /// public class KickAuditLogData : IAuditLogData { diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberRoleAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberRoleAuditLogData.cs index c6f036232..6b31c5a7e 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberRoleAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberRoleAuditLogData.cs @@ -7,7 +7,7 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { /// - /// A piece of audit log data related to a change in a guild member's roles. + /// Contains audit log data related to a change in a guild member's roles. /// public class MemberRoleAuditLogData : IAuditLogData { @@ -36,7 +36,7 @@ namespace Discord.Rest /// Gets a collection of role changes that were performed on the member. /// /// - /// A read-only collection of . + /// A read-only collection of , containing the changes /// public IReadOnlyCollection Roles { get; } /// diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberRoleEditInfo.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberRoleEditInfo.cs index 953d15bb1..9fc402b0d 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberRoleEditInfo.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberRoleEditInfo.cs @@ -1,7 +1,7 @@ namespace Discord.Rest { /// - /// An information object representing a change in one of a member's roles. + /// An information object representing a change in one of a guild member's roles. /// public struct MemberRoleEditInfo { diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberUpdateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberUpdateAuditLogData.cs index 7d3d3dba0..9f8663bcb 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberUpdateAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberUpdateAuditLogData.cs @@ -5,6 +5,9 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { + /// + /// Contains audit log data related to a change in a guild member. + /// public class MemberUpdateAuditLogData : IAuditLogData { private MemberUpdateAuditLogData(IUser target, string newNick, string oldNick) From 580d30fcb502ee98e03a7a0c6e491bcf39b805da Mon Sep 17 00:00:00 2001 From: sarcasmloading <29299928+sarcasmloading@users.noreply.github.com> Date: Wed, 11 Jul 2018 22:19:24 +1200 Subject: [PATCH 3/9] Fix some documentation issues and document some more audit log data types --- .../DataTypes/ChannelCreateAuditLogData.cs | 3 ++- .../DataTypes/MemberRoleAuditLogData.cs | 3 ++- .../DataTypes/MemberUpdateAuditLogData.cs | 18 ++++++++++++++++++ .../DataTypes/MessageDeleteAuditLogData.cs | 16 ++++++++++++++++ .../DataTypes/OverwriteCreateAuditLogData.cs | 9 +++++++++ .../DataTypes/OverwriteDeleteAuditLogData.cs | 9 +++++++++ 6 files changed, 56 insertions(+), 2 deletions(-) diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelCreateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelCreateAuditLogData.cs index d9b6f2ed5..2037bf874 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelCreateAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelCreateAuditLogData.cs @@ -71,7 +71,8 @@ namespace Discord.Rest /// Gets a collection of permission overwrites that was assigned to the created channel. /// /// - /// A collection of permission . + /// A collection of permission , containing the permission overwrites that were + /// assigned to the created channel. /// public IReadOnlyCollection Overwrites { get; } } diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberRoleAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberRoleAuditLogData.cs index 6b31c5a7e..4da2ca196 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberRoleAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberRoleAuditLogData.cs @@ -36,7 +36,8 @@ namespace Discord.Rest /// Gets a collection of role changes that were performed on the member. /// /// - /// A read-only collection of , containing the changes + /// A read-only collection of , containing the roles that were changed on + /// this user. /// public IReadOnlyCollection Roles { get; } /// diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberUpdateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberUpdateAuditLogData.cs index 9f8663bcb..f661aa276 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberUpdateAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberUpdateAuditLogData.cs @@ -30,8 +30,26 @@ namespace Discord.Rest return new MemberUpdateAuditLogData(user, newNick, oldNick); } + /// + /// Gets the user that the changes were performed on. + /// + /// + /// A user object representing the user who the changes were performed on. + /// public IUser Target { get; } + /// + /// Gets the new nickname of the user. + /// + /// + /// A string containing the new nickname of the user; null if the user no longer has a nickname. + /// public string NewNick { get; } + /// + /// Gets the old nickname of the user. + /// + /// + /// A string containing the old nickname of the user; null if the user did not have a nickname. + /// public string OldNick { get; } } } diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MessageDeleteAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MessageDeleteAuditLogData.cs index 3949cdd68..48312ee32 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MessageDeleteAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MessageDeleteAuditLogData.cs @@ -3,6 +3,9 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { + /// + /// Contains audit log data related to message deletion(s). + /// public class MessageDeleteAuditLogData : IAuditLogData { private MessageDeleteAuditLogData(ulong channelId, int count) @@ -16,7 +19,20 @@ namespace Discord.Rest return new MessageDeleteAuditLogData(entry.Options.MessageDeleteChannelId.Value, entry.Options.MessageDeleteCount.Value); } + /// + /// Gets the number of messages that were deleted. + /// + /// + /// An representing the number of messages that were deleted from the channel. + /// public int MessageCount { get; } + /// + /// Gets the ID of the channel that the messages were deleted from. + /// + /// + /// A representing the snowflake identifer for the channel that the messages were + /// deleted from. + /// public ulong ChannelId { get; } } } diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteCreateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteCreateAuditLogData.cs index d58488136..ab6373333 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteCreateAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteCreateAuditLogData.cs @@ -5,6 +5,9 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { + /// + /// Contains audit log data for a permissions overwrite creation. + /// public class OverwriteCreateAuditLogData : IAuditLogData { private OverwriteCreateAuditLogData(Overwrite overwrite) @@ -32,6 +35,12 @@ namespace Discord.Rest return new OverwriteCreateAuditLogData(new Overwrite(id, target, permissions)); } + /// + /// Gets the permission overwrite object that was created. + /// + /// + /// An object representing the overwrite that was created. + /// public Overwrite Overwrite { get; } } } diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteDeleteAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteDeleteAuditLogData.cs index dc2f4a6f0..3c19026e9 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteDeleteAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteDeleteAuditLogData.cs @@ -5,6 +5,9 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { + /// + /// Contains audit log data related to the deletion of a permission overwrite. + /// public class OverwriteDeleteAuditLogData : IAuditLogData { private OverwriteDeleteAuditLogData(Overwrite deletedOverwrite) @@ -31,6 +34,12 @@ namespace Discord.Rest return new OverwriteDeleteAuditLogData(new Overwrite(id, target, new OverwritePermissions(allow, deny))); } + /// + /// Gets the permission overwrite object that was deleted. + /// + /// + /// An object representing the overwrite that was deleted. + /// public Overwrite Overwrite { get; } } } From ac96af34314fdcf175f9090e72c3dca583558e10 Mon Sep 17 00:00:00 2001 From: sarcasmloading <29299928+sarcasmloading@users.noreply.github.com> Date: Wed, 11 Jul 2018 22:20:28 +1200 Subject: [PATCH 4/9] Fix English posession --- .../Entities/AuditLogs/DataTypes/MemberRoleAuditLogData.cs | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberRoleAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberRoleAuditLogData.cs index 4da2ca196..9dd24c862 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberRoleAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberRoleAuditLogData.cs @@ -37,7 +37,7 @@ namespace Discord.Rest /// /// /// A read-only collection of , containing the roles that were changed on - /// this user. + /// the member. /// public IReadOnlyCollection Roles { get; } /// From 541b473d59f9dbb2b9171c81960658383243b20a Mon Sep 17 00:00:00 2001 From: sarcasmloading <29299928+sarcasmloading@users.noreply.github.com> Date: Wed, 11 Jul 2018 23:00:35 +1200 Subject: [PATCH 5/9] Documented two more types --- .../DataTypes/OverwriteUpdateAuditLogData.cs | 30 ++++++++++++++++++- .../AuditLogs/DataTypes/PruneAuditLogData.cs | 18 +++++++++++ 2 files changed, 47 insertions(+), 1 deletion(-) diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteUpdateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteUpdateAuditLogData.cs index d000146c3..5746955a1 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteUpdateAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteUpdateAuditLogData.cs @@ -5,6 +5,9 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { + /// + /// Contains audit log data related to the update of a permission overwrite. + /// public class OverwriteUpdateAuditLogData : IAuditLogData { private OverwriteUpdateAuditLogData(OverwritePermissions before, OverwritePermissions after, ulong targetId, PermissionTarget targetType) @@ -35,10 +38,35 @@ namespace Discord.Rest return new OverwriteUpdateAuditLogData(beforePermissions, afterPermissions, entry.Options.OverwriteTargetId.Value, target); } + /// + /// Gets the overwrite permissions before the changes. + /// + /// + /// An overwrite permissions object representing the overwrite permissions that the overwrite had before + /// the changes were made. + /// public OverwritePermissions OldPermissions { get; } + /// + /// Gets the overwrite permissions after the changes. + /// + /// + /// An overwrite permissions object representing the overwrite permissions that the overwrite now has after + /// the changes. + /// public OverwritePermissions NewPermissions { get; } - + /// + /// Gets the snowflake ID of the overwrite that has been updated. + /// + /// + /// A representing the snowflake identifier of the overwrite that has been updated. + /// public ulong OverwriteTargetId { get; } + /// + /// Gets the target of the updated permission overwrite. + /// + /// + /// The target of the updated permission overwrite. + /// public PermissionTarget OverwriteType { get; } } } diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/PruneAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/PruneAuditLogData.cs index 0005e304d..363a8eff3 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/PruneAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/PruneAuditLogData.cs @@ -3,6 +3,9 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { + /// + /// Contains audit log data related to a guild prune. + /// public class PruneAuditLogData : IAuditLogData { private PruneAuditLogData(int pruneDays, int membersRemoved) @@ -16,7 +19,22 @@ namespace Discord.Rest return new PruneAuditLogData(entry.Options.PruneDeleteMemberDays.Value, entry.Options.PruneMembersRemoved.Value); } + /// + /// Gets the threshold for a guild member to not be kicked. + /// + /// + /// An representing the amount of days that a member must have been seen in the server, + /// to avoid being kicked. (i.e. If a user has not been seen for more than PruneDays, they will be + /// kicked from the server) + /// public int PruneDays { get; } + /// + /// Gets the number of members that were kicked during the purge. + /// + /// + /// An representing the number of members that were removed from this guild for having + /// not been seen within PruneDays. + /// public int MembersRemoved { get; } } } From 812399a42ce795e7b18880376c67546e729006bf Mon Sep 17 00:00:00 2001 From: sarcasmloading <29299928+sarcasmloading@users.noreply.github.com> Date: Thu, 12 Jul 2018 11:34:54 +1200 Subject: [PATCH 6/9] Documented RoleCreateAuditLogData --- .../AuditLogs/DataTypes/RoleCreateAuditLogData.cs | 15 +++++++++++++++ 1 file changed, 15 insertions(+) diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleCreateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleCreateAuditLogData.cs index dcc1c6ab6..89b835de6 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleCreateAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleCreateAuditLogData.cs @@ -5,6 +5,9 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { + /// + /// Contains audit log data related to a role creation. + /// public class RoleCreateAuditLogData : IAuditLogData { private RoleCreateAuditLogData(ulong id, RoleEditInfo props) @@ -41,7 +44,19 @@ namespace Discord.Rest new RoleEditInfo(color, mentionable, hoist, name, permissions)); } + /// + /// Gets the ID of the role that has been created. + /// + /// + /// A representing the snowflake identifer to the role that has been created. + /// public ulong RoleId { get; } + /// + /// Gets the role information that has been created. + /// + /// + /// An information object representing the properties of the role that has been created. + /// public RoleEditInfo Properties { get; } } } From d4598bac11ff88385a324309b8ef3df8cc4b5c93 Mon Sep 17 00:00:00 2001 From: sarcasmloading <29299928+sarcasmloading@users.noreply.github.com> Date: Thu, 12 Jul 2018 12:13:53 +1200 Subject: [PATCH 7/9] Document remaining audit log data types --- .../DataTypes/RoleDeleteAuditLogData.cs | 15 ++++++++ .../AuditLogs/DataTypes/RoleEditInfo.cs | 37 +++++++++++++++++++ .../DataTypes/RoleUpdateAuditLogData.cs | 21 +++++++++++ .../AuditLogs/DataTypes/UnbanAuditLogData.cs | 9 +++++ .../DataTypes/WebhookCreateAuditLogData.cs | 34 ++++++++++++++++- .../DataTypes/WebhookDeleteAuditLogData.cs | 34 +++++++++++++++++ .../AuditLogs/DataTypes/WebhookInfo.cs | 22 +++++++++++ .../DataTypes/WebhookUpdateAuditLogData.cs | 24 +++++++++++- 8 files changed, 192 insertions(+), 4 deletions(-) diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleDeleteAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleDeleteAuditLogData.cs index 263909daf..ab5372ad4 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleDeleteAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleDeleteAuditLogData.cs @@ -5,6 +5,9 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { + /// + /// Contains audit log data relating to a role deletion. + /// public class RoleDeleteAuditLogData : IAuditLogData { private RoleDeleteAuditLogData(ulong id, RoleEditInfo props) @@ -41,7 +44,19 @@ namespace Discord.Rest new RoleEditInfo(color, mentionable, hoist, name, permissions)); } + /// + /// Gets the ID of the role that has been deleted. + /// + /// + /// A representing the snowflake identifer to the role that has been deleted. + /// public ulong RoleId { get; } + /// + /// Gets the role information that has been deleted. + /// + /// + /// An information object representing the properties of the role that has been deleted. + /// public RoleEditInfo Properties { get; } } } diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleEditInfo.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleEditInfo.cs index 186ea8d11..07bc9abf5 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleEditInfo.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleEditInfo.cs @@ -1,5 +1,8 @@ namespace Discord.Rest { + /// + /// Represents information for a role edit. + /// public struct RoleEditInfo { internal RoleEditInfo(Color? color, bool? mentionable, bool? hoist, string name, @@ -12,10 +15,44 @@ namespace Discord.Rest Permissions = permissions; } + /// + /// Gets the color of this role. + /// + /// + /// A color object representing the color assigned to this role; null if this role does not have a + /// color. + /// public Color? Color { get; } + /// + /// Determines whether this role is mentionable (i.e. it can be mentioned in a text channel). + /// + /// + /// true if other members can mention this role in a text channel; otherwise false. + /// public bool? Mentionable { get; } + /// + /// Determines whether this role is hoisted (i.e its members will appear in a seperate section on the user + /// list). + /// + /// + /// true if this role's members will appear in a seperate section in the user list; otherwise + /// false. + /// public bool? Hoist { get; } + /// + /// Gets the name of this role. + /// + /// + /// A string containing the name of this role. + /// public string Name { get; } + /// + /// Gets the permissions assigned to this role. + /// + /// + /// A guild permissions object representing the permissions that have been assigned to this role; null + /// if no permissions have been assigned. + /// public GuildPermissions? Permissions { get; } } } diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleUpdateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleUpdateAuditLogData.cs index b645ef7ae..40a6c2283 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleUpdateAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleUpdateAuditLogData.cs @@ -5,6 +5,9 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { + /// + /// Contains audit log data related to a role update. + /// public class RoleUpdateAuditLogData : IAuditLogData { private RoleUpdateAuditLogData(ulong id, RoleEditInfo oldProps, RoleEditInfo newProps) @@ -55,8 +58,26 @@ namespace Discord.Rest return new RoleUpdateAuditLogData(entry.TargetId.Value, oldProps, newProps); } + /// + /// Gets the ID of the role that has been changed. + /// + /// + /// A representing the snowflake identifier of the role that has been changed. + /// public ulong RoleId { get; } + /// + /// Gets the role information before the changes. + /// + /// + /// A role information object containing the role information before the changes were made. + /// public RoleEditInfo Before { get; } + /// + /// Gets the role information after the changes. + /// + /// + /// A role information object containing the role information after the changes were made. + /// public RoleEditInfo After { get; } } } diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/UnbanAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/UnbanAuditLogData.cs index c94f18271..38615fdd7 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/UnbanAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/UnbanAuditLogData.cs @@ -5,6 +5,9 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { + /// + /// Contains audit log data related to an unban. + /// public class UnbanAuditLogData : IAuditLogData { private UnbanAuditLogData(IUser user) @@ -18,6 +21,12 @@ namespace Discord.Rest return new UnbanAuditLogData(RestUser.Create(discord, userInfo)); } + /// + /// Gets the user that was unbanned. + /// + /// + /// A user object representing the user that was unbanned. + /// public IUser Target { get; } } } diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookCreateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookCreateAuditLogData.cs index 1ae45fb8c..5cc5a0c3d 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookCreateAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookCreateAuditLogData.cs @@ -5,6 +5,9 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { + /// + /// Contains audit log data related to a webhook creation. + /// public class WebhookCreateAuditLogData : IAuditLogData { private WebhookCreateAuditLogData(IWebhook webhook, WebhookType type, string name, ulong channelId) @@ -33,12 +36,39 @@ namespace Discord.Rest return new WebhookCreateAuditLogData(webhook, type, name, channelId); } - //Corresponds to the *current* data + // Doc Note: Corresponds to the *current* data + + /// + /// Gets the webhook that was created. + /// + /// + /// A webhook object representing the webhook that was created. + /// public IWebhook Webhook { get; } - //Corresponds to the *audit log* data + // Doc Note: Corresponds to the *audit log* data + + /// + /// Gets the type of webhook that was created. + /// + /// + /// The type of webhook that was created. + /// public WebhookType Type { get; } + + /// + /// Gets the name of the webhook. + /// + /// + /// A string containing the name of the webhook. + /// public string Name { get; } + /// + /// Gets the ID of the channel that the webhook can send to. + /// + /// + /// A representing the snowflake identifier of the channel that the webhook can send to. + /// public ulong ChannelId { get; } } } diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookDeleteAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookDeleteAuditLogData.cs index 2d536d868..d5a84a696 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookDeleteAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookDeleteAuditLogData.cs @@ -5,6 +5,9 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { + /// + /// Contains audit log data related to a webhook deletion. + /// public class WebhookDeleteAuditLogData : IAuditLogData { private WebhookDeleteAuditLogData(ulong id, ulong channel, WebhookType type, string name, string avatar) @@ -33,10 +36,41 @@ namespace Discord.Rest return new WebhookDeleteAuditLogData(entry.TargetId.Value, channelId, type, name, avatarHash); } + /// + /// Gets the ID of the webhook that was deleted. + /// + /// + /// A representing the snowflake identifier of the webhook that was deleted. + /// public ulong WebhookId { get; } + /// + /// Gets the ID of the channel that the webhook could send to. + /// + /// + /// A representing the snowflake identifier of the channel that the webhook could send + /// to. + /// public ulong ChannelId { get; } + /// + /// Gets the type of the webhook that was deleted. + /// + /// + /// The type of webhook that was deleted. + /// public WebhookType Type { get; } + /// + /// Gets the name of the webhook that was deleted. + /// + /// + /// A string containing the name of the webhook that was deleted. + /// public string Name { get; } + /// + /// Gets the hash value of the webhook's avatar. + /// + /// + /// A string containing the hash of the webhook's avatar. + /// public string Avatar { get; } } } diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookInfo.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookInfo.cs index 26975cc7c..e60157b1a 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookInfo.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookInfo.cs @@ -1,5 +1,8 @@ namespace Discord.Rest { + /// + /// Represents information for a webhook. + /// public struct WebhookInfo { internal WebhookInfo(string name, ulong? channelId, string avatar) @@ -9,8 +12,27 @@ namespace Discord.Rest Avatar = avatar; } + /// + /// Gets the name of this webhook. + /// + /// + /// A string containing the name of this webhook. + /// public string Name { get; } + /// + /// Gets the ID of the channel that this webhook sends to. + /// + /// + /// A representing the snowflake identifier of the channel that this webhook can send + /// to. + /// public ulong? ChannelId { get; } + /// + /// Gets the hash value of this webhook's avatar. + /// + /// + /// A string containing the hash of this webhook's avatar. + /// public string Avatar { get; } } } diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookUpdateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookUpdateAuditLogData.cs index 7db7aee36..b1ac3b97d 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookUpdateAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookUpdateAuditLogData.cs @@ -5,6 +5,9 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { + /// + /// Contains audit log data related to a webhook update. + /// public class WebhookUpdateAuditLogData : IAuditLogData { private WebhookUpdateAuditLogData(IWebhook webhook, WebhookInfo before, WebhookInfo after) @@ -38,11 +41,28 @@ namespace Discord.Rest return new WebhookUpdateAuditLogData(webhook, before, after); } - //Again, the *current* data + /// + /// Gets the webhook that was updated. + /// + /// + /// A webhook objet representing the webhook that was updated. + /// public IWebhook Webhook { get; } - //And the *audit log* data + /// + /// Gets the webhook information before the changes. + /// + /// + /// A webhook information object representing the webhook before the changes were made. + /// public WebhookInfo Before { get; } + + /// + /// Gets the webhook information after the changes. + /// + /// + /// A webhook information object representing the webhook after the changes were made. + /// public WebhookInfo After { get; } } } From cb35aa2b676007605ff7c00db77f7248b93bfd21 Mon Sep 17 00:00:00 2001 From: sarcasmloading <29299928+sarcasmloading@users.noreply.github.com> Date: Fri, 13 Jul 2018 19:34:08 +1200 Subject: [PATCH 8/9] Contains -> Contains a piece of (describe article) --- .../Entities/AuditLogs/DataTypes/BanAuditLogData.cs | 2 +- .../AuditLogs/DataTypes/ChannelCreateAuditLogData.cs | 4 ++-- .../AuditLogs/DataTypes/ChannelDeleteAuditLogData.cs | 2 +- .../AuditLogs/DataTypes/ChannelUpdateAuditLogData.cs | 2 +- .../Entities/AuditLogs/DataTypes/EmoteCreateAuditLogData.cs | 2 +- .../Entities/AuditLogs/DataTypes/EmoteDeleteAuditLogData.cs | 2 +- .../Entities/AuditLogs/DataTypes/EmoteUpdateAuditLogData.cs | 2 +- .../Entities/AuditLogs/DataTypes/GuildUpdateAuditLogData.cs | 2 +- .../AuditLogs/DataTypes/InviteCreateAuditLogData.cs | 4 ++-- .../AuditLogs/DataTypes/InviteDeleteAuditLogData.cs | 4 ++-- .../AuditLogs/DataTypes/InviteUpdateAuditLogData.cs | 2 +- .../Entities/AuditLogs/DataTypes/KickAuditLogData.cs | 2 +- .../Entities/AuditLogs/DataTypes/MemberRoleAuditLogData.cs | 2 +- .../AuditLogs/DataTypes/MemberUpdateAuditLogData.cs | 2 +- .../AuditLogs/DataTypes/MessageDeleteAuditLogData.cs | 4 ++-- .../AuditLogs/DataTypes/OverwriteCreateAuditLogData.cs | 2 +- .../AuditLogs/DataTypes/OverwriteDeleteAuditLogData.cs | 2 +- .../AuditLogs/DataTypes/OverwriteUpdateAuditLogData.cs | 4 ++-- .../Entities/AuditLogs/DataTypes/PruneAuditLogData.cs | 6 +++--- .../Entities/AuditLogs/DataTypes/RoleCreateAuditLogData.cs | 2 +- .../Entities/AuditLogs/DataTypes/RoleDeleteAuditLogData.cs | 2 +- .../Entities/AuditLogs/DataTypes/RoleUpdateAuditLogData.cs | 2 +- .../Entities/AuditLogs/DataTypes/UnbanAuditLogData.cs | 2 +- .../AuditLogs/DataTypes/WebhookCreateAuditLogData.cs | 2 +- .../AuditLogs/DataTypes/WebhookDeleteAuditLogData.cs | 2 +- .../AuditLogs/DataTypes/WebhookUpdateAuditLogData.cs | 2 +- 26 files changed, 33 insertions(+), 33 deletions(-) diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/BanAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/BanAuditLogData.cs index 113b52232..fc807cac0 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/BanAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/BanAuditLogData.cs @@ -6,7 +6,7 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { /// - /// Contains audit log data related to a ban. + /// Contains a piece of audit log data related to a ban. /// public class BanAuditLogData : IAuditLogData { diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelCreateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelCreateAuditLogData.cs index 2037bf874..ae081b1cc 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelCreateAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelCreateAuditLogData.cs @@ -7,7 +7,7 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { /// - /// Contains audit log data related to a channel creation. + /// Contains a piece of audit log data related to a channel creation. /// public class ChannelCreateAuditLogData : IAuditLogData { @@ -71,7 +71,7 @@ namespace Discord.Rest /// Gets a collection of permission overwrites that was assigned to the created channel. /// /// - /// A collection of permission , containing the permission overwrites that were + /// A collection of permission , containing the permission overwrites that were /// assigned to the created channel. /// public IReadOnlyCollection Overwrites { get; } diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelDeleteAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelDeleteAuditLogData.cs index dedcc90db..ea03f4aef 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelDeleteAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelDeleteAuditLogData.cs @@ -7,7 +7,7 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { /// - /// Contains audit log data related to a channel deletion. + /// Contains a piece of audit log data related to a channel deletion. /// public class ChannelDeleteAuditLogData : IAuditLogData { diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelUpdateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelUpdateAuditLogData.cs index eb3f95381..c9e0e9d8b 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelUpdateAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/ChannelUpdateAuditLogData.cs @@ -6,7 +6,7 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { /// - /// Contains audit log data related to a channel update. + /// Contains a piece of audit log data related to a channel update. /// public class ChannelUpdateAuditLogData : IAuditLogData { diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteCreateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteCreateAuditLogData.cs index ec7264c72..ac41d7f58 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteCreateAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteCreateAuditLogData.cs @@ -6,7 +6,7 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { /// - /// Contains audit log data related to an emoji creation. + /// Contains a piece of audit log data related to an emoji creation. /// public class EmoteCreateAuditLogData : IAuditLogData { diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteDeleteAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteDeleteAuditLogData.cs index dd256fbab..b76192d1d 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteDeleteAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteDeleteAuditLogData.cs @@ -6,7 +6,7 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { /// - /// Contains audit log data related to an emoji deletion. + /// Contains a piece of audit log data related to an emoji deletion. /// public class EmoteDeleteAuditLogData : IAuditLogData { diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteUpdateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteUpdateAuditLogData.cs index f1882df2c..d6474e7b2 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteUpdateAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/EmoteUpdateAuditLogData.cs @@ -6,7 +6,7 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { /// - /// Contains audit log data related to an emoji update. + /// Contains a piece of audit log data related to an emoji update. /// public class EmoteUpdateAuditLogData : IAuditLogData { diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/GuildUpdateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/GuildUpdateAuditLogData.cs index fcc2c7920..012919727 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/GuildUpdateAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/GuildUpdateAuditLogData.cs @@ -6,7 +6,7 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { /// - /// Contains audit log data related to a guild update. + /// Contains a piece of audit log data related to a guild update. /// public class GuildUpdateAuditLogData : IAuditLogData { diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteCreateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteCreateAuditLogData.cs index 1d0bc1793..3a208ee5c 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteCreateAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteCreateAuditLogData.cs @@ -6,7 +6,7 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { /// - /// Contains audit log data related to an invite creation. + /// Contains a piece of audit log data related to an invite creation. /// public class InviteCreateAuditLogData : IAuditLogData { @@ -66,7 +66,7 @@ namespace Discord.Rest /// when the user logs off). /// /// - /// true if users accepting this invite will be removed from the guild when they log off; otherwise + /// true if users accepting this invite will be removed from the guild when they log off; otherwise /// false. /// public bool Temporary { get; } diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteDeleteAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteDeleteAuditLogData.cs index 4471f07ca..956598a86 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteDeleteAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteDeleteAuditLogData.cs @@ -6,7 +6,7 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { /// - /// Contains audit log data related to an invite removal. + /// Contains a piece of audit log data related to an invite removal. /// public class InviteDeleteAuditLogData : IAuditLogData { @@ -66,7 +66,7 @@ namespace Discord.Rest /// when the user logs off). /// /// - /// true if users accepting this invite will be removed from the guild when they log off; otherwise + /// true if users accepting this invite will be removed from the guild when they log off; otherwise /// false. /// public bool Temporary { get; } diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteUpdateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteUpdateAuditLogData.cs index 3ecf15548..7ba65e232 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteUpdateAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteUpdateAuditLogData.cs @@ -6,7 +6,7 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { /// - /// Contains audit log data relating to an invite update. + /// Contains a piece of audit log data relating to an invite update. /// public class InviteUpdateAuditLogData : IAuditLogData { diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/KickAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/KickAuditLogData.cs index b00f352a2..dceb73d0a 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/KickAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/KickAuditLogData.cs @@ -6,7 +6,7 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { /// - /// Contains audit log data related to a kick. + /// Contains a piece of audit log data related to a kick. /// public class KickAuditLogData : IAuditLogData { diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberRoleAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberRoleAuditLogData.cs index 9dd24c862..cbba6c83b 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberRoleAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberRoleAuditLogData.cs @@ -7,7 +7,7 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { /// - /// Contains audit log data related to a change in a guild member's roles. + /// Contains a piece of audit log data related to a change in a guild member's roles. /// public class MemberRoleAuditLogData : IAuditLogData { diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberUpdateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberUpdateAuditLogData.cs index f661aa276..64a9733c4 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberUpdateAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberUpdateAuditLogData.cs @@ -6,7 +6,7 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { /// - /// Contains audit log data related to a change in a guild member. + /// Contains a piece of audit log data related to a change in a guild member. /// public class MemberUpdateAuditLogData : IAuditLogData { diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MessageDeleteAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MessageDeleteAuditLogData.cs index 48312ee32..b12f990c8 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MessageDeleteAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MessageDeleteAuditLogData.cs @@ -4,7 +4,7 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { /// - /// Contains audit log data related to message deletion(s). + /// Contains a piece of audit log data related to message deletion(s). /// public class MessageDeleteAuditLogData : IAuditLogData { @@ -30,7 +30,7 @@ namespace Discord.Rest /// Gets the ID of the channel that the messages were deleted from. /// /// - /// A representing the snowflake identifer for the channel that the messages were + /// A representing the snowflake identifer for the channel that the messages were /// deleted from. /// public ulong ChannelId { get; } diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteCreateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteCreateAuditLogData.cs index ab6373333..59403d207 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteCreateAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteCreateAuditLogData.cs @@ -6,7 +6,7 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { /// - /// Contains audit log data for a permissions overwrite creation. + /// Contains a piece of audit log data for a permissions overwrite creation. /// public class OverwriteCreateAuditLogData : IAuditLogData { diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteDeleteAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteDeleteAuditLogData.cs index 3c19026e9..60e63b9db 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteDeleteAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteDeleteAuditLogData.cs @@ -6,7 +6,7 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { /// - /// Contains audit log data related to the deletion of a permission overwrite. + /// Contains a piece of audit log data related to the deletion of a permission overwrite. /// public class OverwriteDeleteAuditLogData : IAuditLogData { diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteUpdateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteUpdateAuditLogData.cs index 5746955a1..a93a7a171 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteUpdateAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteUpdateAuditLogData.cs @@ -6,7 +6,7 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { /// - /// Contains audit log data related to the update of a permission overwrite. + /// Contains a piece of audit log data related to the update of a permission overwrite. /// public class OverwriteUpdateAuditLogData : IAuditLogData { @@ -42,7 +42,7 @@ namespace Discord.Rest /// Gets the overwrite permissions before the changes. /// /// - /// An overwrite permissions object representing the overwrite permissions that the overwrite had before + /// An overwrite permissions object representing the overwrite permissions that the overwrite had before /// the changes were made. /// public OverwritePermissions OldPermissions { get; } diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/PruneAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/PruneAuditLogData.cs index 363a8eff3..1a802fc93 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/PruneAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/PruneAuditLogData.cs @@ -4,7 +4,7 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { /// - /// Contains audit log data related to a guild prune. + /// Contains a piece of audit log data related to a guild prune. /// public class PruneAuditLogData : IAuditLogData { @@ -23,8 +23,8 @@ namespace Discord.Rest /// Gets the threshold for a guild member to not be kicked. /// /// - /// An representing the amount of days that a member must have been seen in the server, - /// to avoid being kicked. (i.e. If a user has not been seen for more than PruneDays, they will be + /// An representing the amount of days that a member must have been seen in the server, + /// to avoid being kicked. (i.e. If a user has not been seen for more than PruneDays, they will be /// kicked from the server) /// public int PruneDays { get; } diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleCreateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleCreateAuditLogData.cs index 89b835de6..a2f9c6d95 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleCreateAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleCreateAuditLogData.cs @@ -6,7 +6,7 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { /// - /// Contains audit log data related to a role creation. + /// Contains a piece of audit log data related to a role creation. /// public class RoleCreateAuditLogData : IAuditLogData { diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleDeleteAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleDeleteAuditLogData.cs index ab5372ad4..632d8e6bd 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleDeleteAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleDeleteAuditLogData.cs @@ -6,7 +6,7 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { /// - /// Contains audit log data relating to a role deletion. + /// Contains a piece of audit log data relating to a role deletion. /// public class RoleDeleteAuditLogData : IAuditLogData { diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleUpdateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleUpdateAuditLogData.cs index 40a6c2283..91b4e8d66 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleUpdateAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleUpdateAuditLogData.cs @@ -6,7 +6,7 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { /// - /// Contains audit log data related to a role update. + /// Contains a piece of audit log data related to a role update. /// public class RoleUpdateAuditLogData : IAuditLogData { diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/UnbanAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/UnbanAuditLogData.cs index 38615fdd7..bc7e7fd4f 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/UnbanAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/UnbanAuditLogData.cs @@ -6,7 +6,7 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { /// - /// Contains audit log data related to an unban. + /// Contains a piece of audit log data related to an unban. /// public class UnbanAuditLogData : IAuditLogData { diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookCreateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookCreateAuditLogData.cs index 5cc5a0c3d..2372a664b 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookCreateAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookCreateAuditLogData.cs @@ -6,7 +6,7 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { /// - /// Contains audit log data related to a webhook creation. + /// Contains a piece of audit log data related to a webhook creation. /// public class WebhookCreateAuditLogData : IAuditLogData { diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookDeleteAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookDeleteAuditLogData.cs index d5a84a696..ec17e872c 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookDeleteAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookDeleteAuditLogData.cs @@ -6,7 +6,7 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { /// - /// Contains audit log data related to a webhook deletion. + /// Contains a piece of audit log data related to a webhook deletion. /// public class WebhookDeleteAuditLogData : IAuditLogData { diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookUpdateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookUpdateAuditLogData.cs index b1ac3b97d..d72bc7b71 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookUpdateAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookUpdateAuditLogData.cs @@ -6,7 +6,7 @@ using EntryModel = Discord.API.AuditLogEntry; namespace Discord.Rest { /// - /// Contains audit log data related to a webhook update. + /// Contains a piece of audit log data related to a webhook update. /// public class WebhookUpdateAuditLogData : IAuditLogData { From b27051bfb1dfaf15b1ad00683a22b5991f6a629f Mon Sep 17 00:00:00 2001 From: sarcasmloading <29299928+sarcasmloading@users.noreply.github.com> Date: Fri, 13 Jul 2018 19:45:40 +1200 Subject: [PATCH 9/9] [EN] Present perf. -> past perf. --- .../AuditLogs/DataTypes/InviteCreateAuditLogData.cs | 2 +- .../AuditLogs/DataTypes/MemberUpdateAuditLogData.cs | 2 +- .../AuditLogs/DataTypes/OverwriteUpdateAuditLogData.cs | 8 ++++---- .../Entities/AuditLogs/DataTypes/PruneAuditLogData.cs | 4 ++-- .../AuditLogs/DataTypes/RoleCreateAuditLogData.cs | 8 ++++---- .../AuditLogs/DataTypes/RoleDeleteAuditLogData.cs | 8 ++++---- .../AuditLogs/DataTypes/RoleUpdateAuditLogData.cs | 4 ++-- .../AuditLogs/DataTypes/WebhookCreateAuditLogData.cs | 5 +++-- 8 files changed, 21 insertions(+), 20 deletions(-) diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteCreateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteCreateAuditLogData.cs index 3a208ee5c..c210d72f0 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteCreateAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/InviteCreateAuditLogData.cs @@ -88,7 +88,7 @@ namespace Discord.Rest /// Gets the number of times this invite has been used. /// /// - /// An representing the number of times this invite has been used. + /// An representing the number of times this invite was used. /// public int Uses { get; } /// diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberUpdateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberUpdateAuditLogData.cs index 64a9733c4..394759a57 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberUpdateAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/MemberUpdateAuditLogData.cs @@ -41,7 +41,7 @@ namespace Discord.Rest /// Gets the new nickname of the user. /// /// - /// A string containing the new nickname of the user; null if the user no longer has a nickname. + /// A string containing the new nickname of the user; null if the user no longer had a nickname. /// public string NewNick { get; } /// diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteUpdateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteUpdateAuditLogData.cs index a93a7a171..15b7b8c0e 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteUpdateAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/OverwriteUpdateAuditLogData.cs @@ -50,15 +50,15 @@ namespace Discord.Rest /// Gets the overwrite permissions after the changes. /// /// - /// An overwrite permissions object representing the overwrite permissions that the overwrite now has after - /// the changes. + /// An overwrite permissions object representing the overwrite permissions that the overwrite had after the + /// changes. /// public OverwritePermissions NewPermissions { get; } /// - /// Gets the snowflake ID of the overwrite that has been updated. + /// Gets the ID of the overwrite that was updated. /// /// - /// A representing the snowflake identifier of the overwrite that has been updated. + /// A representing the snowflake identifier of the overwrite that was updated. /// public ulong OverwriteTargetId { get; } /// diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/PruneAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/PruneAuditLogData.cs index 1a802fc93..c32d12b3f 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/PruneAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/PruneAuditLogData.cs @@ -24,7 +24,7 @@ namespace Discord.Rest /// /// /// An representing the amount of days that a member must have been seen in the server, - /// to avoid being kicked. (i.e. If a user has not been seen for more than PruneDays, they will be + /// to avoid being kicked. (i.e. If a user has not been seen for more than , they will be /// kicked from the server) /// public int PruneDays { get; } @@ -33,7 +33,7 @@ namespace Discord.Rest /// /// /// An representing the number of members that were removed from this guild for having - /// not been seen within PruneDays. + /// not been seen within . /// public int MembersRemoved { get; } } diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleCreateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleCreateAuditLogData.cs index a2f9c6d95..cb87af1ea 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleCreateAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleCreateAuditLogData.cs @@ -45,17 +45,17 @@ namespace Discord.Rest } /// - /// Gets the ID of the role that has been created. + /// Gets the ID of the role that was created. /// /// - /// A representing the snowflake identifer to the role that has been created. + /// A representing the snowflake identifer to the role that was created. /// public ulong RoleId { get; } /// - /// Gets the role information that has been created. + /// Gets the role information that was created. /// /// - /// An information object representing the properties of the role that has been created. + /// An information object representing the properties of the role that was created. /// public RoleEditInfo Properties { get; } } diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleDeleteAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleDeleteAuditLogData.cs index 632d8e6bd..8fbbd12b9 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleDeleteAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleDeleteAuditLogData.cs @@ -45,17 +45,17 @@ namespace Discord.Rest } /// - /// Gets the ID of the role that has been deleted. + /// Gets the ID of the role that was deleted. /// /// - /// A representing the snowflake identifer to the role that has been deleted. + /// A representing the snowflake identifer to the role that was deleted. /// public ulong RoleId { get; } /// - /// Gets the role information that has been deleted. + /// Gets the role information that was deleted. /// /// - /// An information object representing the properties of the role that has been deleted. + /// An information object representing the properties of the role that was deleted. /// public RoleEditInfo Properties { get; } } diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleUpdateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleUpdateAuditLogData.cs index 91b4e8d66..a23a735b4 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleUpdateAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/RoleUpdateAuditLogData.cs @@ -59,10 +59,10 @@ namespace Discord.Rest } /// - /// Gets the ID of the role that has been changed. + /// Gets the ID of the role that was changed. /// /// - /// A representing the snowflake identifier of the role that has been changed. + /// A representing the snowflake identifier of the role that was changed. /// public ulong RoleId { get; } /// diff --git a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookCreateAuditLogData.cs b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookCreateAuditLogData.cs index 2372a664b..05ba0f920 100644 --- a/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookCreateAuditLogData.cs +++ b/src/Discord.Net.Rest/Entities/AuditLogs/DataTypes/WebhookCreateAuditLogData.cs @@ -64,10 +64,11 @@ namespace Discord.Rest /// public string Name { get; } /// - /// Gets the ID of the channel that the webhook can send to. + /// Gets the ID of the channel that the webhook could send to. /// /// - /// A representing the snowflake identifier of the channel that the webhook can send to. + /// A representing the snowflake identifier of the channel that the webhook could send + /// to. /// public ulong ChannelId { get; } }