docs: refine circular buffer code comments

Signed-off-by: Jérôme Benoit <jerome.benoit@piment-noir.org>

diff --git a/src/circular-buffer.ts b/src/circular-buffer.ts
index baa921920f26e3e8b82ebad79f8642577acfc892..9f9678d18dbf439690d3ddd3f8787a6e2ca6fb74 100644 (file)
--- a/src/circular-buffer.ts
+++ b/src/circular-buffer.ts
@@ -1,10 +1,13 @@
 /**
- * Default buffer size
+ * Default buffer size.
  */
 export const defaultBufferSize = 2048
 
 /**
  * Circular buffer
+ *
+ * @typeParam T - Type of buffer data.
+ * @internal
  */
 export class CircularBuffer<T> {
   private readonly readIdx: number
@@ -13,8 +16,8 @@ export class CircularBuffer<T> {
   private readonly maxArrayIdx: number
 
   /**
-   * @param size - Buffer size
-   * @returns CircularBuffer
+   * @param size - Buffer size. @defaultValue defaultBufferSize
+   * @returns CircularBuffer.
    */
   constructor (size: number = defaultBufferSize) {
     this.checkSize(size)
@@ -25,9 +28,9 @@ export class CircularBuffer<T> {
   }
 
   /**
-   * Puts data into buffer
+   * Puts data into buffer.
    *
-   * @param data - Data to put into buffer
+   * @param data - Data to put into buffer.
    */
   public put (data: T): void {
     this.items[this.writeIdx] = data
@@ -35,9 +38,9 @@ export class CircularBuffer<T> {
   }
 
   /**
-   * Returns buffer as array
+   * Returns buffer as array.
    *
-   * @returns T[]
+   * @returns Array of buffer data.
    */
   public toArray (): T[] {
     return this.items.filter(item => item != null) as T[]

diff --git a/src/pools/abstract-pool.ts b/src/pools/abstract-pool.ts
index a7d3e944522e90d5ee5dce103be13cd5e334bdc4..ebdb0dd8924c0e18f71a456c620b1d08a6ad2e6b 100644 (file)
--- a/src/pools/abstract-pool.ts
+++ b/src/pools/abstract-pool.ts
@@ -1473,7 +1473,7 @@ export abstract class AbstractPool<
    * Chooses a worker node for the next task.
    *
    * @param name - The task function name.
-   * @returns The chosen worker node key
+   * @returns The chosen worker node key.
    */
   private chooseWorkerNode (name?: string): number {
     if (this.shallCreateDynamicWorker()) {