docs: Improve XML docs for NameGenerator

src/Moniker/NameGenerator.cs

@@ -33,8 +33,7 @@ public static string Generate(MonikerStyle monikerStyle, string delimiter = Defa
         /// </summary>
         /// <param name="monikerStyle">The style of random name.</param>
         /// <param name="adjective">The adjective part of the random name.</param>
-        /// <param name="noun">The adjective part of the random name.</param>
-        /// <returns>The generated random name.</returns>
+        /// <param name="noun">The noun part of the random name.</param>
         /// <exception cref="ArgumentOutOfRangeException"></exception>
         public static void Generate(MonikerStyle monikerStyle, out Chars adjective, out Chars noun)
         {
@@ -61,7 +60,8 @@ public static string GenerateMoniker(string delimiter = DefaultDelimiter)
         /// <summary>
         /// Generate a random name in the 'moniker' project style.
         /// </summary>
-        /// <returns>The generated random name.</returns>
+        /// <param name="adjective">The adjective part of the random name.</param>
+        /// <param name="noun">The noun part of the random name.</param>
         public static void GenerateMoniker(out Chars adjective, out Chars noun)
             => BuildNamePair(MonikerDescriptors.Strings, out adjective, MonikerAnimals.Strings, out noun);
 
@@ -77,22 +77,6 @@ public static string GenerateMoby(string delimiter = DefaultDelimiter)
             return Join(adjective, delimiter, noun);
         }
 
-        private static string Join(Chars adjective, ReadOnlySpan<char> delimiter, Chars noun)
-        {
-            var length = adjective.Length + delimiter.Length + noun.Length;
-            var chars = length <= 64 ? stackalloc char[length] : new char[length];
-
-            var writeCount = adjective.Write(chars);
-            Debug.Assert(writeCount == adjective.Length);
-
-            delimiter.CopyTo(chars[adjective.Length..]);
-
-            writeCount = noun.Write(chars[(adjective.Length + delimiter.Length)..]);
-            Debug.Assert(writeCount == noun.Length);
-
-            return new(chars);
-        }
-
         /// <summary>
         /// Generate a random name in the 'moby' project style.
         /// </summary>
@@ -125,5 +109,21 @@ private static Chars GetRandomEntry(Utf8Strings entries)
             var index = Random.Shared.Next(entries.Count);
             return entries[index];
         }
+
+        private static string Join(Chars adjective, ReadOnlySpan<char> delimiter, Chars noun)
+        {
+            var length = adjective.Length + delimiter.Length + noun.Length;
+            var chars = length <= 64 ? stackalloc char[length] : new char[length];
+
+            var writeCount = adjective.Write(chars);
+            Debug.Assert(writeCount == adjective.Length);
+
+            delimiter.CopyTo(chars[adjective.Length..]);
+
+            writeCount = noun.Write(chars[(adjective.Length + delimiter.Length)..]);
+            Debug.Assert(writeCount == noun.Length);
+
+            return new(chars);
+        }
     }
 }