Merge pull request #10 from CasinoBoyale/030818-Branch

Added some class summaries

src/Discord.Net.Commands/Attributes/RemarksAttribute.cs

@@ -3,6 +3,9 @@ using System;
 namespace Discord.Commands
 {
     // Extension of the Cosmetic Summary, for Groups, Commands, and Parameters
+    /// <summary>
+    ///     Attaches remarks to your commands.
+    /// </summary>
     [AttributeUsage(AttributeTargets.Method | AttributeTargets.Class, AllowMultiple = false, Inherited = true)]
     public class RemarksAttribute : Attribute
     {

src/Discord.Net.Commands/Attributes/SummaryAttribute.cs

@@ -3,6 +3,9 @@ using System;
 namespace Discord.Commands
 {
     // Cosmetic Summary, for Groups and Commands
+    /// <summary>
+    ///     Attaches a summary to your command.
+    /// </summary>
     [AttributeUsage(AttributeTargets.Method | AttributeTargets.Class | AttributeTargets.Parameter, AllowMultiple = false, Inherited = true)]
     public class SummaryAttribute : Attribute
     {

src/Discord.Net.Commands/Info/ModuleInfo.cs

@@ -6,6 +6,9 @@ using Discord.Commands.Builders;
 
 namespace Discord.Commands
 {
+    /// <summary>
+    ///     Provides the information of a module.
+    /// </summary>
     public class ModuleInfo
     {
         public CommandService Service { get; }

src/Discord.Net.Commands/Info/ParameterInfo.cs

@@ -7,6 +7,9 @@ using System.Threading.Tasks;
 
 namespace Discord.Commands
 {
+    /// <summary>
+    ///     Provides the information of a parameter.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class ParameterInfo
     {

src/Discord.Net.Commands/ModuleBase.cs

@@ -4,8 +4,15 @@ using Discord.Commands.Builders;
 
 namespace Discord.Commands
 {
+    /// <summary>
+    ///     Provides a base class for a command module to inherit from.
+    /// </summary>
     public abstract class ModuleBase : ModuleBase<ICommandContext> { }
 
+    /// <summary>
+    ///     Provides a base class for a command module to inherit from.
+    /// </summary>
+    /// <typeparam name="T">A class that implements <see cref="ICommandContext"/>.</typeparam>
     public abstract class ModuleBase<T> : IModuleBase
         where T : class, ICommandContext
     {

src/Discord.Net.Rest/Entities/Channels/RestGroupChannel.cs

@@ -10,6 +10,9 @@ using Model = Discord.API.Channel;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Represents a REST-based group-message channel.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class RestGroupChannel : RestChannel, IGroupChannel, IRestPrivateChannel, IRestMessageChannel, IRestAudioChannel
     {

src/Discord.Net.Rest/Entities/Guilds/RestVoiceRegion.cs

@@ -4,6 +4,9 @@ using Model = Discord.API.VoiceRegion;
 
 namespace Discord
 {
+    /// <summary>
+    ///     Represents a REST-based voice region.
+    /// </summary>
     [DebuggerDisplay("{DebuggerDisplay,nq}")]
     public class RestVoiceRegion : RestEntity<string>, IVoiceRegion
     {

src/Discord.Net.Rest/Entities/Messages/RestMessage.cs

@@ -7,6 +7,9 @@ using Model = Discord.API.Message;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Represents a REST-based message.
+    /// </summary>
     public abstract class RestMessage : RestEntity<ulong>, IMessage, IUpdateable
     {
         private long _timestampTicks;

src/Discord.Net.Rest/Entities/Messages/RestSystemMessage.cs

@@ -3,6 +3,9 @@ using Model = Discord.API.Message;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Represents a REST-based system message.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class RestSystemMessage : RestMessage, ISystemMessage
     {

src/Discord.Net.Rest/Entities/Messages/RestUserMessage.cs

@@ -8,6 +8,9 @@ using Model = Discord.API.Message;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Represents a REST-based message sent by a user.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class RestUserMessage : RestMessage, IUserMessage
     {

src/Discord.Net.Rest/Entities/Roles/RestRole.cs

@@ -5,6 +5,9 @@ using Model = Discord.API.Role;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Represents a REST-based role.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class RestRole : RestEntity<ulong>, IRole
     {

src/Discord.Net.Rest/Entities/Users/RestGroupUser.cs

@@ -3,6 +3,9 @@ using Model = Discord.API.User;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Represents a REST-based group user.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class RestGroupUser : RestUser, IGroupUser
     {

src/Discord.Net.Rest/Entities/Users/RestGuildUser.cs

@@ -8,6 +8,9 @@ using Model = Discord.API.GuildMember;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Represents a REST-based guild user.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class RestGuildUser : RestUser, IGuildUser
     {

src/Discord.Net.Rest/Entities/Users/RestSelfUser.cs

@@ -5,6 +5,9 @@ using Model = Discord.API.User;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Represents the logged-in REST-based user.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class RestSelfUser : RestUser, ISelfUser
     {

src/Discord.Net.Rest/Entities/Users/RestUser.cs

@@ -5,6 +5,9 @@ using Model = Discord.API.User;
 
 namespace Discord.Rest
 {
+    /// <summary>
+    ///     Represents a REST-based user.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class RestUser : RestEntity<ulong>, IUser, IUpdateable
     {

src/Discord.Net.WebSocket/Entities/Users/SocketWebhookUser.cs

@@ -7,6 +7,9 @@ using Model = Discord.API.User;
 
 namespace Discord.WebSocket
 {
+    /// <summary>
+    ///     Represents a WebSocket-based webhook user.
+    /// </summary>
     [DebuggerDisplay(@"{DebuggerDisplay,nq}")]
     public class SocketWebhookUser : SocketUser, IWebhookUser
     {