Merge branch 'feature/command-localization' of https://github.com/discord-net/Discord.Net into localization

src/Discord.Net.Core/Entities/Guilds/IGuild.cs

@@ -1198,7 +1198,7 @@ namespace Discord
         ///     Whether to include full localization dictionaries in the returned objects,
         ///     instead of the localized name and description fields.
         /// </param>
-        /// <param name="locale">The target locale of the localized name and description fields. Sets <c>X-Discord-Locale</c> header, which takes precedence over <c>Accept-Language</c>.</param>
+        /// <param name="locale">The target locale of the localized name and description fields. Sets the <c>X-Discord-Locale</c> header, which takes precedence over <c>Accept-Language</c>.</param>
         /// <param name="options">The options to be used when sending the request.</param>
         /// <returns>
         ///     A task that represents the asynchronous get operation. The task result contains a read-only collection

src/Discord.Net.Core/Entities/Interactions/ContextMenus/MessageCommandBuilder.cs

@@ -100,7 +100,7 @@ namespace Discord
         /// <summary>
         ///     Sets the <see cref="NameLocalizations"/> collection.
         /// </summary>
-        /// <param name="nameLocalizations">Localization dictionary for the name field of this command.</param>
+        /// <param name="nameLocalizations">The localization dictionary to use for the name field of this command.</param>
         /// <returns></returns>
         /// <exception cref="ArgumentNullException">Thrown if <paramref name="nameLocalizations"/> is null.</exception>
         /// <exception cref="ArgumentException">Thrown if any dictionary key is an invalid locale string.</exception>

src/Discord.Net.Core/Entities/Interactions/ContextMenus/UserCommandBuilder.cs

@@ -98,7 +98,7 @@ namespace Discord
         /// <summary>
         ///     Sets the <see cref="NameLocalizations"/> collection.
         /// </summary>
-        /// <param name="nameLocalizations">Localization dictionary for the name field of this command.</param>
+        /// <param name="nameLocalizations">The localization dictionary to use for the name field of this command.</param>
         /// <returns>The current builder.</returns>
         /// <exception cref="ArgumentNullException">Thrown if <paramref name="nameLocalizations"/> is null.</exception>
         /// <exception cref="ArgumentException">Thrown if any dictionary key is an invalid locale string.</exception>

src/Discord.Net.Core/Entities/Interactions/IApplicationCommandOption.cs

@@ -63,17 +63,17 @@ namespace Discord
         IReadOnlyCollection<ChannelType> ChannelTypes { get; }
 
         /// <summary>
-        ///     Gets the localization dictionary for the name field of this command.
+        ///     Gets the localization dictionary for the name field of this command option.
         /// </summary>
         IReadOnlyDictionary<string, string> NameLocalizations { get; }
 
         /// <summary>
-        ///     Gets the localization dictionary for the description field of this command.
+        ///     Gets the localization dictionary for the description field of this command option.
         /// </summary>
         IReadOnlyDictionary<string, string> DescriptionLocalizations { get; }
 
         /// <summary>
-        ///     Gets the localized name of this command.
+        ///     Gets the localized name of this command option.
         /// </summary>
         /// <remarks>
         ///     Only returned when the `withLocalizations` query parameter is set to <see langword="false"/> when requesting the command.
@@ -81,7 +81,7 @@ namespace Discord
         string NameLocalized { get; }
 
         /// <summary>
-        ///     Gets the localized description of this command.
+        ///     Gets the localized description of this command option.
         /// </summary>
         /// <remarks>
         ///     Only returned when the `withLocalizations` query parameter is set to true when requesting the command.

src/Discord.Net.Core/Entities/Interactions/IApplicationCommandOptionChoice.cs

@@ -18,12 +18,12 @@ namespace Discord
         object Value { get; }
 
         /// <summary>
-        ///     Gets the localization dictionary for the name field of this command.
+        ///     Gets the localization dictionary for the name field of this command option.
         /// </summary>
         IReadOnlyDictionary<string, string> NameLocalizations { get; }
 
         /// <summary>
-        ///     Gets the localized name of this command.
+        ///     Gets the localized name of this command option.
         /// </summary>
         /// <remarks>
         ///     Only returned when the `withLocalizations` query parameter is set to <see langword="false"/> when requesting the command.

src/Discord.Net.Core/Entities/Interactions/SlashCommands/SlashCommandBuilder.cs

@@ -282,7 +282,7 @@ namespace Discord
         /// <summary>
         ///     Sets the <see cref="NameLocalizations"/> collection.
         /// </summary>
-        /// <param name="nameLocalizations">Localization dictionary for the name field of this command.</param>
+        /// <param name="nameLocalizations">The localization dictionary to use for the name field of this command.</param>
         /// <returns></returns>
         /// <exception cref="ArgumentNullException">Thrown if <paramref name="nameLocalizations"/> is null.</exception>
         /// <exception cref="ArgumentException">Thrown if any dictionary key is an invalid locale string.</exception>
@@ -306,7 +306,7 @@ namespace Discord
         /// <summary>
         ///     Sets the <see cref="DescriptionLocalizations"/> collection.
         /// </summary>
-        /// <param name="descriptionLocalizations">Localization dictionary for the name field of this command.</param>
+        /// <param name="descriptionLocalizations">The localization dictionary to use for the description field of this command.</param>
         /// <returns></returns>
         /// <exception cref="ArgumentNullException">Thrown if <paramref name="descriptionLocalizations"/> is null.</exception>
         /// <exception cref="ArgumentException">Thrown if any dictionary key is an invalid locale string.</exception>
@@ -640,7 +640,7 @@ namespace Discord
         /// </summary>
         /// <param name="name">The name of the choice.</param>
         /// <param name="value">The value of the choice.</param>
-        /// <param name="nameLocalizations">Localization dictionary for the description field of this command.</param>
+        /// <param name="nameLocalizations">The localization dictionary for to use the name field of this command option choice.</param>
         /// <returns>The current builder.</returns>
         public SlashCommandOptionBuilder AddChoice(string name, int value, IDictionary<string, string> nameLocalizations = null)
         {
@@ -652,7 +652,7 @@ namespace Discord
         /// </summary>
         /// <param name="name">The name of the choice.</param>
         /// <param name="value">The value of the choice.</param>
-        /// <param name="nameLocalizations">Localization dictionary for the description field of this command.</param>
+        /// <param name="nameLocalizations">The localization dictionary for to use the name field of this command option choice.</param>
         /// <returns>The current builder.</returns>
         public SlashCommandOptionBuilder AddChoice(string name, string value, IDictionary<string, string> nameLocalizations = null)
         {
@@ -676,7 +676,7 @@ namespace Discord
         /// </summary>
         /// <param name="name">The name of the choice.</param>
         /// <param name="value">The value of the choice.</param>
-        /// <param name="nameLocalizations">Localization dictionary for the description field of this command.</param>
+        /// <param name="nameLocalizations">The localization dictionary to use for the name field of this command option choice.</param>
         /// <returns>The current builder.</returns>
         public SlashCommandOptionBuilder AddChoice(string name, float value, IDictionary<string, string> nameLocalizations = null)
         {
@@ -688,7 +688,7 @@ namespace Discord
         /// </summary>
         /// <param name="name">The name of the choice.</param>
         /// <param name="value">The value of the choice.</param>
-        /// <param name="nameLocalizations">Localization dictionary for the description field of this command.</param>
+        /// <param name="nameLocalizations">The localization dictionary to use for the name field of this command option choice.</param>
         /// <returns>The current builder.</returns>
         public SlashCommandOptionBuilder AddChoice(string name, long value, IDictionary<string, string> nameLocalizations = null)
         {
@@ -830,7 +830,7 @@ namespace Discord
         /// <summary>
         ///     Sets the <see cref="NameLocalizations"/> collection.
         /// </summary>
-        /// <param name="nameLocalizations">Localization dictionary for the name field of this command.</param>
+        /// <param name="nameLocalizations">The localization dictionary to use for the name field of this command option.</param>
         /// <returns>The current builder.</returns>
         /// <exception cref="ArgumentNullException">Thrown if <paramref name="nameLocalizations"/> is null.</exception>
         /// <exception cref="ArgumentException">Thrown if any dictionary key is an invalid locale string.</exception>
@@ -854,7 +854,7 @@ namespace Discord
         /// <summary>
         ///     Sets the <see cref="DescriptionLocalizations"/> collection.
         /// </summary>
-        /// <param name="descriptionLocalizations">Localization dictionary for the description field of this command.</param>
+        /// <param name="descriptionLocalizations">The localization dictionary to use for the description field of this command option.</param>
         /// <returns>The current builder.</returns>
         /// <exception cref="ArgumentNullException">Thrown if <paramref name="descriptionLocalizations"/> is null.</exception>
         /// <exception cref="ArgumentException">Thrown if any dictionary key is an invalid locale string.</exception>

src/Discord.Net.Interactions/LocalizationManagers/ILocalizationManager.cs

@@ -5,7 +5,7 @@ using System.Threading.Tasks;
 namespace Discord.Interactions
 {
     /// <summary>
-    ///     Respresents localization provider for Discord Application Commands.
+    ///     Respresents a localization provider for Discord Application Commands.
     /// </summary>
     public interface ILocalizationManager
     {