From 4c5f02b221dcbe47034ec7afd1f6401f7775c653 Mon Sep 17 00:00:00 2001
From: Oliver Booth <me@olivr.me>
Date: Wed, 10 Mar 2021 11:29:10 +0000
Subject: [PATCH] (#15) Explicitly describe return value

---
 X10D/src/StringExtensions/StringExtensions.cs | 10 ++++++++--
 1 file changed, 8 insertions(+), 2 deletions(-)

diff --git a/X10D/src/StringExtensions/StringExtensions.cs b/X10D/src/StringExtensions/StringExtensions.cs
index d9bcb96..ce192b3 100644
--- a/X10D/src/StringExtensions/StringExtensions.cs
+++ b/X10D/src/StringExtensions/StringExtensions.cs
@@ -14,7 +14,10 @@ namespace X10D.StringExtensions
         ///     Returns the current string, or <see langword="null" /> if the current string is null or empty.
         /// </summary>
         /// <param name="value">The value to sanitize.</param>
-        /// <returns><see langword="null" /> or <paramref name="value" />.</returns>
+        /// <returns>
+        ///     <see langword="null" /> if <paramref name="value" /> is <see langword="null" /> or equal to
+        ///     <see cref="string.Empty" />, or <paramref name="value" /> otherwise.
+        /// </returns>
         public static string? AsNullIfEmpty(this string value)
         {
             return string.IsNullOrEmpty(value) ? null : value;
@@ -25,7 +28,10 @@ namespace X10D.StringExtensions
         ///     whitespace.
         /// </summary>
         /// <param name="value">The value to sanitize.</param>
-        /// <returns><see langword="null" /> or <paramref name="value" />.</returns>
+        /// <returns>
+        ///     <see langword="null" /> if <paramref name="value" /> is <see langword="null" /> or equal to
+        ///     <see cref="string.Empty" /> or is composed of only whitespace characters, or <paramref name="value" /> otherwise.
+        /// </returns>
         public static string? AsNullIfWhiteSpace(this string value)
         {
             return string.IsNullOrWhiteSpace(value) ? null : value;