XML Documentation Updates (Again)

NetCord/Account.cs

@@ -1,13 +1,20 @@
 namespace NetCord;
 
+/// <summary>
+/// Represents an account as part of an <see cref="Integration"/> object.
+/// </summary>
+/// <param name="jsonModel">The JSON model to create an <see cref="Integration"/> object from.</param>
 public class Account(JsonModels.JsonAccount jsonModel) : Entity, IJsonModel<JsonModels.JsonAccount>
 {
     JsonModels.JsonAccount IJsonModel<JsonModels.JsonAccount>.JsonModel => jsonModel;
 
+    /// <summary>
+    /// The ID of the account.
+    /// </summary>
     public override ulong Id => jsonModel.Id;
 
     /// <summary>
-    /// Name of the account.
+    /// The name of the account.
     /// </summary>
     public string Name => jsonModel.Name;
 }

NetCord/Application.cs

@@ -2,40 +2,19 @@
 
 namespace NetCord;
 
+/// <summary>
+/// Applications or 'apps', are containers for developer platform features, and can be installed to guilds and/or user accounts.
+/// </summary>
 public partial class Application : ClientEntity, IJsonModel<JsonModels.JsonApplication>
 {
     JsonModels.JsonApplication IJsonModel<JsonModels.JsonApplication>.JsonModel => _jsonModel;
     private readonly JsonModels.JsonApplication _jsonModel;
 
-    public override ulong Id => _jsonModel.Id;
-    public string Name => _jsonModel.Name;
-    public string? IconHash => _jsonModel.IconHash;
-    public string Description => _jsonModel.Description;
-    public IReadOnlyList<string> RpcOrigins => _jsonModel.RpcOrigins;
-    public bool? BotPublic => _jsonModel.BotPublic;
-    public bool? BotRequireCodeGrant => _jsonModel.BotRequireCodeGrant;
-    public User? Bot { get; }
-    public string? TermsOfServiceUrl => _jsonModel.TermsOfServiceUrl;
-    public string? PrivacyPolicyUrl => _jsonModel.PrivacyPolicyUrl;
-    public User? Owner { get; }
-    public string VerifyKey => _jsonModel.VerifyKey;
-    public Team? Team { get; }
-    public ulong? GuildId => _jsonModel.GuildId;
-    public RestGuild? Guild { get; }
-    public ulong? PrimarySkuId => _jsonModel.PrimarySkuId;
-    public string? Slug => _jsonModel.Slug;
-    public string? CoverImageHash => _jsonModel.CoverImageHash;
-    public ApplicationFlags? Flags => _jsonModel.Flags;
-    public int? ApproximateGuildCount => _jsonModel.ApproximateGuildCount;
-    public int? ApproximateUserInstallCount => _jsonModel.ApproximateUserInstallCount;
-    public IReadOnlyList<string>? RedirectUris => _jsonModel.RedirectUris;
-    public string? InteractionsEndpointUrl => _jsonModel.InteractionsEndpointUrl;
-    public string? RoleConnectionsVerificationUrl => _jsonModel.RoleConnectionsVerificationUrl;
-    public IReadOnlyList<string>? Tags => _jsonModel.Tags;
-    public ApplicationInstallParams? InstallParams { get; }
-    public IReadOnlyDictionary<ApplicationIntegrationType, ApplicationIntegrationTypeConfiguration>? IntegrationTypesConfiguration { get; }
-    public string? CustomInstallUrl => _jsonModel.CustomInstallUrl;
-
+    /// <summary>
+    /// Constructs an <see cref="Application"/> using a JSON Model and <see cref="RestClient"/>.
+    /// </summary>
+    /// <param name="jsonModel">The JSON model to create an <see cref="Application"/> from.</param>
+    /// <param name="client">The <see cref="RestClient"/> to use for construction.</param>
     public Application(JsonModels.JsonApplication jsonModel, RestClient client) : base(client)
     {
         _jsonModel = jsonModel;
@@ -65,13 +44,177 @@ public Application(JsonModels.JsonApplication jsonModel, RestClient client) : ba
             IntegrationTypesConfiguration = integrationTypesConfiguration.ToDictionary(i => i.Key, i => new ApplicationIntegrationTypeConfiguration(i.Value));
     }
 
+    /// <summary>
+    /// The ID of the application.
+    /// </summary>
+    public override ulong Id => _jsonModel.Id;
+
+    /// <summary>
+    /// The name of the application.
+    /// </summary>
+    public string Name => _jsonModel.Name;
+
+    /// <summary>
+    /// The icon hash of the application.
+    /// </summary>
+    public string? IconHash => _jsonModel.IconHash;
+
+    /// <summary>
+    /// The description of the application.
+    /// </summary>
+    public string Description => _jsonModel.Description;
+
+    /// <summary>
+    /// The application's RPC origin URL list, where <c>T</c> is of type <see cref="string"/>. <see langword="null"/> if RPC is disabled.
+    /// </summary>
+    public IReadOnlyList<string> RpcOrigins => _jsonModel.RpcOrigins;
+
+    /// <summary>
+    /// When <see langword="false"/>, only the application owner can add the application to guilds.
+    /// </summary>
+    public bool? BotPublic => _jsonModel.BotPublic;
+
+    /// <summary>
+    /// When <see langword="true"/>, the application's bot will only join upon completion of the full OAuth2 code grant flow.
+    /// </summary>
+    public bool? BotRequireCodeGrant => _jsonModel.BotRequireCodeGrant;
+
+    /// <summary>
+    /// The partial <see cref="User"/> object of the application's bot.
+    /// </summary>
+    public User? Bot { get; }
+
+    /// <summary>
+    /// The application's Terms of Service URL.
+    /// </summary>
+    public string? TermsOfServiceUrl => _jsonModel.TermsOfServiceUrl;
+
+    /// <summary>
+    /// The application's Privacy Policy URL.
+    /// </summary>
+    public string? PrivacyPolicyUrl => _jsonModel.PrivacyPolicyUrl;
+
+    /// <summary>
+    /// The partial <see cref="User"/> object of the application's owner.
+    /// </summary>
+    public User? Owner { get; }
+
+    /// <summary>
+    /// The hex-encoded verification key used for interactions and the GameSDK's GetTicket.
+    /// </summary>
+    public string VerifyKey => _jsonModel.VerifyKey;
+
+    /// <summary>
+    /// The team the application belongs to. Is <see langword="null"/> if the application does not belong to a team.
+    /// </summary>
+    public Team? Team { get; }
+
+    /// <summary>
+    /// The ID of the guild associated with the application. For example, a developer support server.
+    /// </summary>
+    public ulong? GuildId => _jsonModel.GuildId;
+
+    /// <summary>
+    /// The partial <see cref="RestGuild"/> object of the application's associated guild.
+    /// </summary>
+    public RestGuild? Guild { get; }
+
+    /// <summary>
+    /// The ID of the Game SKU created, if one exists. Is <see langword="null"/> if the application is not a game sold on Discord.
+    /// </summary>
+    public ulong? PrimarySkuId => _jsonModel.PrimarySkuId;
+
+    /// <summary>
+    /// The URL slug that links to an application's store page. Is <see langword="null"/> if the application is not a game sold on Discord.
+    /// </summary>
+    public string? Slug => _jsonModel.Slug;
+
+    /// <summary>
+    /// The cover image hash of the application's default rich presence invite.
+    /// </summary>
+    public string? CoverImageHash => _jsonModel.CoverImageHash;
+
+    /// <summary>
+    /// The application's public flags.
+    /// </summary>
+    public ApplicationFlags? Flags => _jsonModel.Flags;
+
+    /// <summary>
+    /// The approximate number of guilds the application has been added to.
+    /// </summary>
+    public int? ApproximateGuildCount => _jsonModel.ApproximateGuildCount;
+
+    /// <summary>
+    /// The approximate number of users that have installed the application.
+    /// </summary>
+    public int? ApproximateUserInstallCount => _jsonModel.ApproximateUserInstallCount;
+
+    /// <summary>
+    /// The application's redirect URI list.
+    /// </summary>
+    public IReadOnlyList<string>? RedirectUris => _jsonModel.RedirectUris;
+
+    /// <summary>
+    /// The application's interactions endpoint URL.
+    /// </summary>
+    public string? InteractionsEndpointUrl => _jsonModel.InteractionsEndpointUrl;
+
+    /// <summary>
+    /// The application's role connection verification URL.
+    /// </summary>
+    public string? RoleConnectionsVerificationUrl => _jsonModel.RoleConnectionsVerificationUrl;
+
+    /// <summary>
+    /// The application's tag list, describing its content and functionality. Max of 5 tags.
+    /// </summary>
+    public IReadOnlyList<string>? Tags => _jsonModel.Tags;
+
+    /// <summary>
+    /// The application's default in-app authorization URL. Is <see langword="null"/> if disabled.
+    /// </summary>
+    public ApplicationInstallParams? InstallParams { get; }
+
+    /// <summary>
+    /// The default scopes and permissions for each supported installation context.
+    /// </summary>
+    public IReadOnlyDictionary<ApplicationIntegrationType, ApplicationIntegrationTypeConfiguration>? IntegrationTypesConfiguration { get; }
+
+    /// <summary>
+    /// The application's default customization URL. Is <see langword="null"/> if disabled.
+    /// </summary>
+    public string? CustomInstallUrl => _jsonModel.CustomInstallUrl;
+
+    /// <summary>
+    /// Gets the <see cref="ImageUrl"/> of the application's icon.
+    /// </summary>
+    /// <param name="format">The format of the returned <see cref="ImageUrl"/>. Defaults to <see cref="ImageFormat.Png"/>.</param>
     public ImageUrl? GetIconUrl(ImageFormat format) => IconHash is string hash ? ImageUrl.ApplicationIcon(Id, hash, format) : null;
 
+    /// <summary>
+    /// Gets the <see cref="ImageUrl"/> of the application's cover.
+    /// </summary>
+    /// <param name="format">The format of the returned <see cref="ImageUrl"/>. Defaults to <see cref="ImageFormat.Png"/>.</param>
     public ImageUrl? GetCoverUrl(ImageFormat format) => CoverImageHash is string hash ? ImageUrl.ApplicationCover(Id, hash, format) : null;
 
+    /// <summary>
+    /// Gets the <see cref="ImageUrl"/> of the an asset associated with the application.
+    /// </summary>
+    /// <param name="assetId">The ID of the asset to get an <see cref="ImageUrl"/> for.</param>
+    /// <param name="format">The format of the returned <see cref="ImageUrl"/>. Defaults to <see cref="ImageFormat.Png"/>.</param>
     public ImageUrl? GetAssetUrl(ulong assetId, ImageFormat format) => ImageUrl.ApplicationAsset(Id, assetId, format);
 
+    /// <summary>
+    /// Gets the <see cref="ImageUrl"/> of an achievement associated with the application.
+    /// </summary>
+    /// <param name="achievementId">The ID of the achievement to get an <see cref="ImageUrl"/> for.</param>
+    /// <param name="iconHash">The hash of the achievement's icon.</param>
+    /// <param name="format">The format of the returned <see cref="ImageUrl"/>. Defaults to <see cref="ImageFormat.Png"/>.</param>
     public ImageUrl? GetAchievementIconUrl(ulong achievementId, string iconHash, ImageFormat format) => ImageUrl.AchievementIcon(Id, achievementId, iconHash, format);
 
+    /// <summary>
+    /// Gets the <see cref="ImageUrl"/> of a store page asset associated with the application.
+    /// </summary>
+    /// <param name="assetId">The ID of the asset to get an <see cref="ImageUrl"/> for.</param>
+    /// <param name="format">The format of the returned <see cref="ImageUrl"/>. Defaults to <see cref="ImageFormat.Png"/>.</param>
     public ImageUrl? GetStorePageAssetUrl(ulong assetId, ImageFormat format) => ImageUrl.StorePageAsset(Id, assetId, format);
 }

NetCord/ChannelType.cs

@@ -1,18 +1,77 @@
 namespace NetCord;
 
+/// <summary>
+/// The type of a channel, dictating its features.
+/// </summary>
 public enum ChannelType
 {
+    /// <summary>
+    /// A text channel within a guild.
+    /// </summary>
     TextGuildChannel = 0,
+
+    /// <summary>
+    /// A text channel for direct messages between two users.
+    /// </summary>
     DMChannel = 1,
+
+    /// <summary>
+    /// A voice channel within a guild.
+    /// </summary>
     VoiceGuildChannel = 2,
+
+    /// <summary>
+    /// A text channel for direct messages between multiple users.
+    /// </summary>
     GroupDMChannel = 3,
+
+    /// <summary>
+    /// An organizational category that contains up to 50 channels.
+    /// </summary>
     CategoryChannel = 4,
+
+    /// <summary>
+    /// A channel that users can follow and crosspost into their own guild (formerly news channels).
+    /// </summary>
     AnnouncementGuildChannel = 5,
+
+    /// <summary>
+    /// A channel that allows users to purchase subscriptions, roles or downloadables for real-life currency in guilds.
+    /// </summary>
+    StoreGuildChannel = 6,
+
+    /// <summary>
+    /// A temporary sub-channel within an <see cref="AnnouncementGuildChannel"/>.
+    /// </summary>
     AnnouncementGuildThread = 10,
+
+    /// <summary>
+    /// A temporary sub-channel within a <see cref="TextGuildChannel"/> or <see cref="ForumGuildChannel"/>.
+    /// </summary>
     PublicGuildThread = 11,
+
+    /// <summary>
+    /// A temporary sub-channel within a <see cref="TextGuildChannel"/> that is only viewable by those invited and/or those with the <see cref="Permissions.ManageThreads"/> permission.
+    /// </summary>
     PrivateGuildThread = 12,
+
+    /// <summary>
+    /// A voice channel for hosting events with an audience.
+    /// </summary>
     StageGuildChannel = 13,
+
+    /// <summary>
+    /// The channel in a hub containing the listed guilds.
+    /// </summary>
     DirectoryGuildChannel = 14,
+
+    /// <summary>
+    /// A channel that can only contain threads.
+    /// </summary>
     ForumGuildChannel = 15,
+
+    /// <summary>
+    /// Channels that can only contain threads, similar to a <see cref="ForumGuildChannel"/>, but still in active development.
+    /// </summary>
     MediaForumGuildChannel = 16,
 }