cleanup, docs

site/doc/pages/crypto_equal.txt

@@ -1,10 +1,20 @@
-# crypto_equal
+:sig
+bool crypto_equal(String a, String b)
 
+:params
+a : first value
+b : second value
+return value : true if the byte strings are equal
 
-Constant-time byte comparison for secrets such as MACs and tokens.
+:content
+Compares two byte strings in constant time, so the comparison takes the same time whether they differ in the first byte or the last. Always use it to check secrets such as HMACs, tokens, and password hashes — `==` can leak how much of a secret matched via timing.
 
 :example
-print(crypto_equal("abc", "abc") ? "same\n" : "different\n");
+String expected = hmac_sha256_hex("key", "payload");
+print(crypto_equal(expected, hmac_sha256_hex("key", "payload")) ? "valid" : "invalid", " / ");
+print(crypto_equal(expected, "tampered") ? "valid" : "invalid", "\n");
 
 :see
->noise
+>sys
+hmac_sha256_hex
+sha256_hex