chore: pull across relevant docs from rust definitions

noir_stdlib/src/cmp.nr

@@ -315,10 +315,34 @@ impl<A, B, C, D, E> Ord for (A, B, C, D, E) where A: Ord, B: Ord, C: Ord, D: Ord
     }
 }
 
+/// Compares and returns the maximum of two values.
+///
+/// Returns the second argument if the comparison determines them to be equal.
+///
+/// # Examples
+///
+/// ```
+/// use std::cmp;
+///
+/// assert_eq(cmp::max(1, 2), 2);
+/// assert_eq(cmp::max(2, 2), 2);
+/// ```
 pub fn max<T>(v1: T, v2: T) -> T where T: Ord {
     if v1 > v2 { v1 } else { v2 }
 }
 
+// Compares and returns the minimum of two values.
+//
+// Returns the first argument if the comparison determines them to be equal.
+//
+// # Examples
+//
+// ```
+// use std::cmp;
+//
+// assert_eq(cmp::min(1, 2), 1);
+// assert_eq(cmp::min(2, 2), 2);
+// ```
 pub fn min<T>(v1: T, v2: T) -> T where T: Ord {
     if v1 > v2 { v2 } else { v1 }
 }