Improved documentation

Kerobot/Services/EntityCache/EntityCacheService.cs

@@ -18,7 +18,7 @@ namespace Kerobot.Services.EntityCache
         }
 
         /// <summary>
-        /// See documentation in Kerobot_hooks.
+        /// See <see cref="Kerobot.EcQueryUser(ulong, string)"/>.
         /// </summary>
         internal Task<CachedUser> QueryUserCache(ulong guildId, string search) => _uc.Query(guildId, search);
     }

Kerobot/Services/EntityCache/Kerobot_hooks.cs

@@ -13,8 +13,8 @@ namespace Kerobot
         /// cached user will be returned.
         /// </summary>
         /// <param name="guildId">ID of the corresponding guild in which to search.</param>
-        /// <param name="search">Search string. Either </param>
-        /// <returns>A <see cref="CachedUser"/> instance containing cached information.</returns>
+        /// <param name="search">Search string. May be a name with discriminator, a name, or an ID.</param>
+        /// <returns>A <see cref="CachedUser"/> instance containing cached information, or null if no result.</returns>
         public Task<CachedUser> EcQueryUser(ulong guildId, string search) => _svcEntityCache.QueryUserCache(guildId, search);
     }
 }

Kerobot/Services/EntityCache/UserCacheService.cs

@@ -1,7 +1,6 @@
 using Discord.WebSocket;
 using NpgsqlTypes;
 using System;
-using System.Collections.Generic;
 using System.Text.RegularExpressions;
 using System.Threading.Tasks;
 
@@ -133,6 +132,9 @@ namespace Kerobot.Services.EntityCache
         #region Querying
         private static Regex DiscriminatorSearch = new Regex(@"(.+)#(\d{4}(?!\d))", RegexOptions.Compiled);
 
+        /// <summary>
+        /// See <see cref="Kerobot.EcQueryUser(ulong, string)"/>.
+        /// </summary>
         internal async Task<CachedUser> Query(ulong guildID, string search)
         {
             // Is search just a number? Assume ID, pass it on to the correct place.