fix test name and improve xml docs

Author: adelinowona

src/MongoDB.Driver/SortDefinitionBuilder.cs

@@ -131,7 +131,9 @@ public static SortDefinition<TDocument> MetaTextScore<TDocument>(this SortDefini
     public sealed class SortDefinitionBuilder<TDocument>
     {
         /// <summary>
-        /// Creates a value ascending sort.
+        /// Creates a value ascending sort that sorts documents by their entire document value. For example, "$sort: 1"
+        /// This is typically used when documents are simple values (like strings, numbers, or dates)
+        /// rather than complex objects with multiple fields.
         /// </summary>
         /// <returns>A value ascending sort.</returns>
         public SortDefinition<TDocument> Ascending()
@@ -140,7 +142,8 @@ public SortDefinition<TDocument> Ascending()
         }
 
         /// <summary>
-        /// Creates an ascending sort.
+        /// Creates an ascending sort based on a specific field within the document. For example, "$sort: {field: 1}"
+        /// This is used when documents are complex objects, and you want to sort by a particular field's value.
         /// </summary>
         /// <param name="field">The field.</param>
         /// <returns>An ascending sort.</returns>
@@ -150,7 +153,8 @@ public SortDefinition<TDocument> Ascending(FieldDefinition<TDocument> field)
         }
 
         /// <summary>
-        /// Creates an ascending sort.
+        /// Creates an ascending sort based on a specific field within the document. For example, "$sort: {field: 1}"
+        /// This is used when documents are complex objects, and you want to sort by a particular field's value.
         /// </summary>
         /// <param name="field">The field.</param>
         /// <returns>An ascending sort.</returns>
@@ -180,7 +184,9 @@ public SortDefinition<TDocument> Combine(IEnumerable<SortDefinition<TDocument>>
         }
 
         /// <summary>
-        /// Creates a value descending sort.
+        /// Creates a value descending sort that sorts documents by their entire document value. For example, "$sort: -1"
+        /// This is typically used when documents are simple values (like strings, numbers, or dates)
+        /// rather than complex objects with multiple fields.
         /// </summary>
         /// <returns>A value descending sort.</returns>
         public SortDefinition<TDocument> Descending()
@@ -189,7 +195,8 @@ public SortDefinition<TDocument> Descending()
         }
 
         /// <summary>
-        /// Creates a descending sort.
+        /// Creates a descending sort based on a specific field within the document. For example, "$sort: {field: -1}"
+        /// This is used when documents are complex objects, and you want to sort by a particular field's value.
         /// </summary>
         /// <param name="field">The field.</param>
         /// <returns>A descending sort.</returns>
@@ -199,7 +206,8 @@ public SortDefinition<TDocument> Descending(FieldDefinition<TDocument> field)
         }
 
         /// <summary>
-        /// Creates a descending sort.
+        /// Creates a descending sort based on a specific field within the document. For example, "$sort: {field: -1}"
+        /// This is used when documents are complex objects, and you want to sort by a particular field's value.
         /// </summary>
         /// <param name="field">The field.</param>
         /// <returns>A descending sort.</returns>

tests/MongoDB.Driver.Tests/SortDefinitionBuilderTests.cs

@@ -145,7 +145,7 @@ public void MetaTextScore()
         }
 
         [Fact]
-        public void CallingRenderOnValueBasedSortShouldThrow()
+        public void Calling_render_on_value_based_sort_should_throw()
         {
             var subject = CreateSubject<BsonDocument>();