Fix audit findings for coverage, architecture checks, and XML docs

tests/CBDD.Tests.Benchmark/SerializationBenchmarks.cs

@@ -27,7 +27,7 @@ public class SerializationBenchmarks
     private static readonly System.Collections.Concurrent.ConcurrentDictionary<string, ushort> _keyMap = new(StringComparer.OrdinalIgnoreCase);
     private static readonly System.Collections.Concurrent.ConcurrentDictionary<ushort, string> _keys = new();
 
-    static SerializationBenchmarks()
+    static SerializationBenchmarks()
     {
         ushort id = 1;
         string[] initialKeys = { "_id", "firstname", "lastname", "age", "bio", "createdat", "balance", "homeaddress", "street", "city", "zipcode", "employmenthistory", "companyname", "title", "durationyears", "tags" };
@@ -47,8 +47,11 @@ public class SerializationBenchmarks
         }
     }
 
-    [GlobalSetup]
-    public void Setup()
+    /// <summary>
+    /// Prepares benchmark data for serialization and deserialization scenarios.
+    /// </summary>
+    [GlobalSetup]
+    public void Setup()
     {
         _person = CreatePerson(0);
         _people = new List<Person>(BatchSize);
@@ -108,39 +111,54 @@ public class SerializationBenchmarks
         return p;
     }
 
-    [Benchmark(Description = "Serialize Single (BSON)")]
-    [BenchmarkCategory("Single")]
-    public void Serialize_Bson()
+    /// <summary>
+    /// Benchmarks BSON serialization for a single document.
+    /// </summary>
+    [Benchmark(Description = "Serialize Single (BSON)")]
+    [BenchmarkCategory("Single")]
+    public void Serialize_Bson()
     {
         var writer = new BsonSpanWriter(_serializeBuffer, _keyMap);
         _mapper.Serialize(_person, writer);
     }
 
-    [Benchmark(Description = "Serialize Single (JSON)")]
-    [BenchmarkCategory("Single")]
-    public void Serialize_Json()
+    /// <summary>
+    /// Benchmarks JSON serialization for a single document.
+    /// </summary>
+    [Benchmark(Description = "Serialize Single (JSON)")]
+    [BenchmarkCategory("Single")]
+    public void Serialize_Json()
     {
         JsonSerializer.SerializeToUtf8Bytes(_person);
     }
 
-    [Benchmark(Description = "Deserialize Single (BSON)")]
-    [BenchmarkCategory("Single")]
-    public Person Deserialize_Bson()
+    /// <summary>
+    /// Benchmarks BSON deserialization for a single document.
+    /// </summary>
+    [Benchmark(Description = "Deserialize Single (BSON)")]
+    [BenchmarkCategory("Single")]
+    public Person Deserialize_Bson()
     {
         var reader = new BsonSpanReader(_bsonData, _keys);
         return _mapper.Deserialize(reader);
     }
 
-    [Benchmark(Description = "Deserialize Single (JSON)")]
-    [BenchmarkCategory("Single")]
-    public Person? Deserialize_Json()
+    /// <summary>
+    /// Benchmarks JSON deserialization for a single document.
+    /// </summary>
+    [Benchmark(Description = "Deserialize Single (JSON)")]
+    [BenchmarkCategory("Single")]
+    public Person? Deserialize_Json()
     {
         return JsonSerializer.Deserialize<Person>(_jsonData);
     }
 
-    [Benchmark(Description = "Serialize List 10k (BSON loop)")]
-    [BenchmarkCategory("Batch")]
-    public void Serialize_List_Bson()
+    /// <summary>
+    /// Benchmarks BSON serialization for a list of documents.
+    /// </summary>
+    [Benchmark(Description = "Serialize List 10k (BSON loop)")]
+    [BenchmarkCategory("Batch")]
+    public void Serialize_List_Bson()
     {
         foreach (var p in _people)
         {
@@ -149,9 +167,12 @@ public class SerializationBenchmarks
         }
     }
 
-    [Benchmark(Description = "Serialize List 10k (JSON loop)")]
-    [BenchmarkCategory("Batch")]
-    public void Serialize_List_Json()
+    /// <summary>
+    /// Benchmarks JSON serialization for a list of documents.
+    /// </summary>
+    [Benchmark(Description = "Serialize List 10k (JSON loop)")]
+    [BenchmarkCategory("Batch")]
+    public void Serialize_List_Json()
     {
         foreach (var p in _people)
         {
@@ -159,9 +180,12 @@ public class SerializationBenchmarks
         }
     }
 
-    [Benchmark(Description = "Deserialize List 10k (BSON loop)")]
-    [BenchmarkCategory("Batch")]
-    public void Deserialize_List_Bson()
+    /// <summary>
+    /// Benchmarks BSON deserialization for a list of documents.
+    /// </summary>
+    [Benchmark(Description = "Deserialize List 10k (BSON loop)")]
+    [BenchmarkCategory("Batch")]
+    public void Deserialize_List_Bson()
     {
         foreach (var data in _bsonDataList)
         {
@@ -170,9 +194,12 @@ public class SerializationBenchmarks
         }
     }
 
-    [Benchmark(Description = "Deserialize List 10k (JSON loop)")]
-    [BenchmarkCategory("Batch")]
-    public void Deserialize_List_Json()
+    /// <summary>
+    /// Benchmarks JSON deserialization for a list of documents.
+    /// </summary>
+    [Benchmark(Description = "Deserialize List 10k (JSON loop)")]
+    [BenchmarkCategory("Batch")]
+    public void Deserialize_List_Json()
     {
         foreach (var data in _jsonDataList)
         {