From c0ab988c3441f02b2dd8a5bb55f8912d293240a2 Mon Sep 17 00:00:00 2001
From: Chris Johnston <chjohnston@protonmail.com>
Date: Sun, 13 Jan 2019 09:18:43 -0800
Subject: [PATCH] Add summary tag verbs, example of IUser locale

---
 src/Discord.Net.Core/Entities/Activities/IActivity.cs | 2 +-
 src/Discord.Net.Core/Entities/Users/IUser.cs          | 9 +++++----
 2 files changed, 6 insertions(+), 5 deletions(-)

diff --git a/src/Discord.Net.Core/Entities/Activities/IActivity.cs b/src/Discord.Net.Core/Entities/Activities/IActivity.cs
index 869d780c9..a2ab06bcd 100644
--- a/src/Discord.Net.Core/Entities/Activities/IActivity.cs
+++ b/src/Discord.Net.Core/Entities/Activities/IActivity.cs
@@ -20,7 +20,7 @@ namespace Discord
         /// </returns>
         ActivityType Type { get; }
         /// <summary>
-        ///     The flags that are relevant to this activity.
+        ///     Gets the flags that are relevant to this activity.
         /// </summary>
         /// <remarks>
         ///     This value is determined by bitwise OR-ing <see cref="ActivityFlag"/> values together.
diff --git a/src/Discord.Net.Core/Entities/Users/IUser.cs b/src/Discord.Net.Core/Entities/Users/IUser.cs
index f99f777fb..a3bfc4cba 100644
--- a/src/Discord.Net.Core/Entities/Users/IUser.cs
+++ b/src/Discord.Net.Core/Entities/Users/IUser.cs
@@ -113,7 +113,7 @@ namespace Discord
         /// </returns>
         Task<IDMChannel> GetOrCreateDMChannelAsync(RequestOptions options = null);
         /// <summary>
-        ///     The flags that are applied to a user's account.
+        ///     Gets the flags that are applied to a user's account.
         /// </summary>
         /// <remarks>
         ///     This value is determined by bitwise OR-ing <see cref="UserFlag"/> values together.
@@ -123,7 +123,7 @@ namespace Discord
         /// </returns>
         UserFlag Flags { get; }
         /// <summary>
-        ///     The type of Nitro subscription that is active on this user's account.
+        ///     Gets the type of Nitro subscription that is active on this user's account.
         /// </summary>
         /// <remarks>
         ///     This information may only be available with the identify OAuth scope,
@@ -134,10 +134,11 @@ namespace Discord
         /// </returns>
         PremiumType? PremiumType { get; }
         /// <summary>
-        ///     The user's chosen language option.
+        ///     Gets the user's chosen language option.
         /// </summary>
         /// <returns>
-        ///     The value of the user's chosen language option, if provided.
+        ///     The IETF language tag of the user's chosen region, if provided.
+        ///     For example, a locale of "English, US" is "en-US", "Chinese (Taiwan)" is "zh-TW", etc.
         /// </returns>
         string Locale { get; }
     }