docs: clarify what hash() does

Author: pi0

README.md

@@ -13,7 +13,7 @@ Fast data [hashing](https://en.wikipedia.org/wiki/Hash_function) utils.
 
 ## Usage
 
-Install package:
+Install `ohash`:
 
 <!--automd:pm-install -->
 
@@ -39,19 +39,19 @@ deno install ohash
 
 <!--/automd -->
 
-Import:
+**Import:**
 
 ```js
 // ESM import
-import { hash, objectHash, stringDigest } from "ohash";
+import { hash, objectHash, isEqual, diff, stringDigest } from "ohash";
 
 // ..or dnamic import
 const { hash, objectHash, stringDigest } = await import("ohash");
 ```
 
 ### `hash(object, options?)`
 
-Serializes any value into a string hash using `objectHash` and then hashes result sha256+base64 (using `stringDigest`) trimmed by length of `10`.
+Hashes any JS value into a string.
 
 **Usage:**
 
@@ -62,6 +62,12 @@ import { hash } from "ohash";
 console.log(hash({ foo: "bar" }));
 ```
 
+**How it works:**
+
+- Input will be serialized into a string like `"object:1:string:3:foo:string:3:bar,"`
+- Then it is hashed using [SHA-256](https://en.wikipedia.org/wiki/SHA-2) algorithm and encoded as a [base64](https://en.wikipedia.org/wiki/Base64) string
+- `+`, `/` and `=` characters will be removed and string trimmed to `10` chars
+
 ### `objectHash(object, options?)`
 
 Serializes any value into a stable and safe string for hashing.

src/hash/hash.ts

@@ -2,12 +2,16 @@ import { objectHash, type HashOptions } from "./object-hash";
 import { stringDigest } from "ohash/crypto";
 
 /**
- * Hash any JS value into a string.
+ * Hashes any JS value into a string.
+ *
+ * **How it works:**
+ * - Input will be serialized into a string like `"object:1:string:3:foo:string:3:bar,"`
+ * - Then it is hashed using [SHA-256](https://en.wikipedia.org/wiki/SHA-2) algorithm and encoded as a [base64](https://en.wikipedia.org/wiki/Base64) string
+ * - `+`, `/` and `=` characters will be removed and string trimmed to `10` chars
  *
  * @param {object} object value to hash
  * @param {HashOptions} options hashing options. See {@link HashOptions}.
  * @return {string} hash value
- * @api public
  */
 export function hash(object: any, options: HashOptions = {}): string {
   const hashed =