Add more explanatory comments

src/Concurrent/CMap.cs

@@ -640,31 +640,55 @@ private static ref T Find<T>(T[] array, uint index)
 
         #endregion
 
+        /// <summary>
+        /// Represents an entry in the hash table.
+        /// </summary>
         [StructLayout(LayoutKind.Sequential)]
-        [DebuggerDisplay("key = {Key}; value = {Value}; meta {Meta};")]
+        [DebuggerDisplay("key = {Key}; value = {Value}; meta = {Meta};")]
         internal struct Entry
         {
+            /// <summary>
+            /// The state of the entry, used for locking. 0 indicates unlocked, 1 indicates locked.
+            /// </summary>
             internal byte state;
+
+            /// <summary>
+            /// Metadata associated with the entry. This is used to indicate the state of the entry,
+            /// such as whether it is empty, a tombstone, in-progress, or not empty (H2 hash)
+            /// </summary>
             internal sbyte Meta;
+
+            /// <summary>
+            /// The key of the entry.
+            /// </summary>
             internal TKey Key;
+
+            /// <summary>
+            /// The value of the entry.
+            /// </summary>
             internal TValue Value;
 
             /// <summary>
             /// Enters a critical section by acquiring a lock. Ensures thread safety.
+            /// This method uses a spin lock with exponential backoff to reduce contention.
             /// </summary>
             [MethodImpl(MethodImplOptions.AggressiveInlining)]
             public void Enter()
             {
-                int spinCount = 1;
+                int spinCount = 1; // Initialize spin count for exponential backoff
 
                 while (true)
                 {
+                    // Attempt to acquire the lock by setting the state to 1 if it is currently 0
                     if (Interlocked.CompareExchange(ref state, 1, 0) == 0)
                     {
-                        return;
+                        return; // Lock acquired successfully, exit the method
                     }
 
+                    // Perform a spin wait to allow other threads to progress
                     Thread.SpinWait(spinCount);
+
+                    // Increment the spin count exponentially, but cap it to prevent excessive delays
                     if (spinCount < 1024)
                     {
                         spinCount *= 2;
@@ -683,27 +707,87 @@ internal class Table
         {
             #region Fields
 
+            /// <summary>
+            /// The bit shift value used in hash calculation to determine bucket index.
+            /// </summary>
             private byte _shift = 32;
+
+            /// <summary>
+            /// The bitmask value used for secondary hash calculation.
+            /// </summary>
             private const sbyte _bitmask = (1 << 6) - 1;
+
+            /// <summary>
+            /// A constant value based on the golden ratio, used for hash calculation.
+            /// </summary>
             private const uint _goldenRatio = 0x9E3779B9;
+
+            /// <summary>
+            /// The size of each group of entries for migration purposes.
+            /// </summary>
             internal uint _groupSize;
+
+            /// <summary>
+            /// The total number of groups in the table.
+            /// </summary>
             internal int _depleted;
+
+            /// <summary>
+            /// The current index of the group being processed during migration.
+            /// </summary>
             private uint _groupIndex;
 
             #endregion
 
             #region Properties
 
+            /// <summary>
+            /// The array of entries in the hash table.
+            /// </summary>
             public Entry[] Entries;
+
+            /// <summary>
+            /// Length of the table minus one, used for efficient modulus operations.
+            /// </summary>
             public uint LengthMinusOne;
+
+            /// <summary>
+            /// Threshold for resizing the table, based on the load factor.
+            /// </summary>
             public uint Threshold;
+
+            /// <summary>
+            /// The current length of the table.
+            /// </summary>
             public uint Length;
+
+            /// <summary>
+            /// The number of groups minus one, used for group indexing.
+            /// </summary>
             private uint _groupsMinusOne;
+
+            /// <summary>
+            /// Counter for the number of depleted groups during migration.
+            /// </summary>
             internal int _depletedCounter;
+
+            /// <summary>
+            /// The maximum distance to jump during quadratic probing.
+            /// </summary>
             public byte MaxJumpDistance { get; internal set; }
 
             #endregion
 
+            #region Constructor
+
+            /// <summary>
+            /// Creates a new table with the specified length and load factor.
+            /// </summary>
+            /// <param name="length">The length of the table.</param>
+            /// <param name="_loadFactor">The load factor of the table.</param>
+
+            #endregion
+
             /// <summary>
             /// Creates a new table with the specified length and load factor.
             /// </summary>

src/Faster.Map.csproj

@@ -10,16 +10,16 @@
       Add robinhood hashmap and quadratic hashmap
     </PackageReleaseNotes>
     <PackageProjectUrl>https://github.com/Wsm2110/Faster.Map</PackageProjectUrl>
-    <AssemblyVersion>5.0.4</AssemblyVersion>
-    <FileVersion>5.0.4</FileVersion>
+    <AssemblyVersion>6.0.0</AssemblyVersion>
+    <FileVersion>6.0.0</FileVersion>
     <Title>Fastest .net hashmap</Title>
-    <Version>5.0.4</Version>
+    <Version>6.0.0</Version>
     <GeneratePackageOnBuild>True</GeneratePackageOnBuild>
     <Description>Cutting-edge NuGet package offering high-performance hash map implementations leveraging SIMD (Single Instruction, Multiple Data) instructions. This innovative library combines the efficiency of SIMD operations with advanced hashing techniques </Description>
     <RepositoryUrl>https://github.com/Wsm2110/Faster.Map</RepositoryUrl>
     <RepositoryType>git</RepositoryType>
     <PackageLicenseExpression>MIT</PackageLicenseExpression>
-    <PackageTags>Hashmap Hashtable Dictionary Faster.map performance, simd, robinhood hashing, swisstable, absl</PackageTags>
+    <PackageTags>Hashmap Hashtable Dictionary Faster.map performance, concurrency, simd, robinhood hashing, swisstable, absl</PackageTags>
   </PropertyGroup>
 
   <PropertyGroup>