update docs

prelude/__internal__/Function.mad

@@ -111,7 +111,8 @@ export when = (predicate, truthy, value) => ifElse(predicate, truthy, always(val
  * otherwise return the initial value.
  * @since 0.23.1
  * @example
- * unless(equals(5), (x) => x * 10, 5) // 
+ * unless(equals(5), (x) => x * 10, 5) // 5
+ * unless(equals(5), (x) => x * 10, 4) // 40
  */
 unless :: (a -> Boolean) -> (a -> a) -> a -> a
 export unless = (predicate, falsy, value) => ifElse(predicate, always(value), falsy, value)
@@ -142,7 +143,6 @@ export noop = (_) => ({})
 flip :: (a -> b -> c) -> b -> a -> c
 export flip = (f) => ((b, a) => f(a, b))
 
-
 /**
  * Functional "or", given two predicates and a value, return true if either predicate is true.
  *

prelude/__internal__/List.mad

@@ -1070,7 +1070,7 @@ export all = (predicate, list) => where(list) {
 }
 
 /**
- * Cut a given array at the specificed index and return a tuple of #[beforeIndex, afterIndex] slices
+ * Cut a given array at the specific index and return a tuple of #[beforeIndex, afterIndex] slices
  * @since 0.23.1
  * @example
  * cut(5, range(1, 11)) // #[ [1,2,3,4,5], [6,7,8,9,10]]

prelude/__internal__/Tuple.mad

@@ -1,21 +1,45 @@
+/**
+ * Get the first value of a binary tuple
+ * @since 0.23.1
+ * @example
+ * fst(#["a", "b"]) // "a"
+ */
 fst :: #[a, b] -> a
 export fst = (tuple) => where(tuple) {
   #[a, _] =>
     a
 }
 
+/**
+ * Get the second value of a binary tuple
+ * @since 0.23.1
+ * @example
+ * snd(#["a", "b"]) // "b"
+ */
 snd :: #[a, b] -> b
 export snd = (tuple) => where(tuple) {
   #[_, b] =>
     b
 }
 
+/**
+ * Transform the first value of a binary tuple
+ * @since 0.23.1
+ * @example
+ * mapFst(Math.times(2), #[3, 4]) // #[6, 4]
+ */
 mapFst :: (a -> b) -> #[a, c] -> #[b, c]
 export mapFst = (fn, tuple) => where(tuple) {
   #[a, b] =>
     #[fn(a), b]
 }
 
+/**
+ * Transform the second value of a binary tuple
+ * @since 0.23.1
+ * @example
+ * mapFst(Math.times(2), #[3, 4]) // #[3, 8]
+ */
 mapSnd :: (b -> c) -> #[a, b] -> #[a, c]
 export mapSnd = (fn, tuple) => where(tuple) {
   #[a, b] =>