Improve comments

Author: SignalRT

LLama/Batched/BatchedExecutor.cs

@@ -19,6 +19,7 @@ public sealed class BatchedExecutor
     private int _batchQueueHead;
     private int _batchedTokenCount;
     private bool _batchedTokenCountDirty = true;
+    // Skip compacting the queue until this many processed batches accumulate at the front.
     private const int CleanupThreshold = 16;
 
     /// <summary>
@@ -205,6 +206,7 @@ void RequeueFront(IBatch batch)
             _batchedTokenCountDirty = true;
         }
 
+        // Remove batches that have already been consumed so the head index does not grow without bound.
         void CleanupQueue()
         {
             if (_batchQueueHead == 0)

LLama/Common/FixedSizeQueue.cs

@@ -16,7 +16,9 @@ public class FixedSizeQueue<T>
         private int _count;
         private T[]? _window;
 
+        // Minimum capacity for the temporary buffer used to expose a contiguous view.
         private const int MinimumWindowSize = 4;
+        // Resize multiplier for the temporary buffer to reduce copy churn as it grows.
         private const int WindowGrowthFactor = 2;
 
         /// <inheritdoc />
@@ -123,6 +125,9 @@ IEnumerator IEnumerable.GetEnumerator()
             return GetEnumerator();
         }
 
+        /// <summary>
+        /// Returns up to <paramref name="count"/> of the most recent items as a contiguous span.
+        /// </summary>
         internal ReadOnlySpan<T> AsSpan(int count)
         {
             count = Math.Min(count, _count);