improve quality of comments

src/classes.ts

@@ -35,7 +35,7 @@ let idCounter = 0
  * const monoid = new Class({
  *  name: 'Monoid',
  *  extends: [eq],
- *  laws: all(append, commutativity, associativity, identity)
+ *  laws: all(append, associativity, identity)
  * })
  * ```
  *
@@ -67,24 +67,18 @@ export class Class {
     values: Generator<T>,
     options: ValidationOptions = {},
   ): ValidationResult {
-    // check cache
     if (cache.contains(Constructor, this)) {
       return MaybeError.success()
     }
 
-    // not cached
     const result = MaybeError.foldConjoin([
-      // parents
       ...this.parents.map((parent) =>
         parent.validate(Constructor, values, options),
       ),
-      // constructor itself
       this.laws.check(Constructor, values, options),
     ])
 
-    // cache
     cache.set(Constructor, this)
-
     return result
   }
 

src/generators.ts

@@ -21,7 +21,7 @@ export class Continuous<T extends Constructor> implements Generator<T> {
   /**
    *
    * @param f A function from _n_ real numbers in the range [0, 1] to a value of
-   * T
+   * T.
    * @param random A function that generates pseudo-random numbers. For each
    * value that is instantiated, this function will be called with a different
    * parameter `x`, and every random parameter will be a different `y`.
@@ -54,7 +54,7 @@ export class Discrete<T extends Constructor> implements Generator<T> {
 
   /**
    *
-   * @param values A list of discrete values the constructor may assume
+   * @param values A list of discrete values the constructor may assume.
    */
   constructor(
     public readonly values: InstanceType<T>[],
@@ -91,7 +91,7 @@ export function continuous<T extends Constructor>(
 }
 
 /**
- * Generate testing values from a finite list
+ * Generate testing values from a finite list.
  *
  * @example
  * ```

src/utils.ts

@@ -53,12 +53,10 @@ export class MaybeError extends Maybe<string> {
     }
   }
 
-  // not very functional
   isSuccess() {
     return this.value === null
   }
 
-  // not very functional
   isError() {
     return !this.isSuccess()
   }