Update README

Author: rav2040

README.md

@@ -4,31 +4,43 @@
 [![Coverage Status](https://coveralls.io/repos/github/tuftjs/json-stringify/badge.svg?branch=master)](https://coveralls.io/github/tuftjs/json-stringify?branch=master)
 [![Known Vulnerabilities](https://snyk.io/test/github/tuftjs/json-stringify/badge.svg?targetFile=package.json)](https://snyk.io/test/github/tuftjs/json-stringify?targetFile=package.json)
 
-A JSON library for Node.js that exports the following functions:
+A JSON library for Node.js that exports the following set of functions:
+
 * [jsonStringify()](#jsonstringifyvalue-safe)
 * [stableJsonStringify()](#stablejsonstringifyvalue-comparefunction-safe)
 
+These functions prioritize performance at the expense of certain features. The serialized JSON output of these functions is identical to that of `JSON.stringify()` with the following exceptions:
+
+1. When serializing strings, only quotation marks (`"`) and backslashes (`\`) are escaped. As the vast majority of strings in real world usage do not include ASCII control characters or lone surrogate code points, a significant performance boost is gained by not checking for their presence. If you require this functionality, it is best to stick with `JSON.stringify()` or another alternative.
+2. `toJSON()` methods are completely ignored. However, `Buffer` and `Date` objects *will* be transformed to represent the same output you would get from `JSON.stringify()`.
+
+These functions also do not have *replacer* or *space* parameters like `JSON.stringify()` does.
+
+⚠ **Note:**  
+By default, a check will be made on all nested objects and arrays for circular references, and an `Error` will be thrown if one is encountered. Setting the *safe* parameter to `false` will disable this check and grant a considerable speed boost. If a circular reference is found when *safe* is set to `false`, the internal serialization function will be called recursively until the call stack size is exceeded.
+
 ## Installation
 
 ```bash
 npm i @tuft/json-stringify
 ```
 
-</br>
-<p align="center">
-  🔹 🔹 🔹
-</p>
-</br>
+## API
 
 ### jsonStringify(*value*[, *safe*])
 
-A more performant version of `JSON.stringify()`. Strings produced by this function are identical (not accounting for the order of keys) to the output of `JSON.stringify()`, and it works the same with the following exceptions:
-* There are no *replacer* or *space* parameters.
-* There **is** a *safe* parameter (see below).
-* `toJSON()` methods are completely ignored. However, `Buffer` and `Date` objects will be transformed to represent the same output you would get from `JSON.stringify()`.
+Converts a JavaScript object or value to a JSON string. The following are valid data types that can be converted to JSON:
+
+* `null`
+* Boolean
+* Number
+* String
+* Array
+* Object
+* `Date`**
+* `Buffer`**
 
-⚠ **Important note:**  
-By default a check will be made on all nested objects and arrays for circular references, and an `Error` will be thrown if one is encountered. Setting the *safe* parameter to `false` will disable this check and grant a considerable speed boost, but this should not be done unless it is certain the given object contains no circular references.
+\*\* `Date` and `Buffer` objects are serialized in a way that matches the output of their respective `toJSON()` methods.
 
 #### Parameters
 
@@ -58,15 +70,9 @@ const obj = {
 jsonStringify(obj);  // '{"foo":42,"hello":"world"}'
 ```
 
-</br>
-<p align="center">
-  🔹 🔹 🔹
-</p>
-</br>
-
 ### stableJsonStringify(*value*,[ *compareFunction*[, *safe*]])
 
-A deterministic version of `jsonStringify()`. It performs the same as `jsonStringify()` with the exception that object entries are sorted before being serialized. This ensures that consistent output is produced for the same input, at the cost of reduced performance.
+A deterministic version of `jsonStringify()`. It performs the same, with the exception that object entries are sorted before being serialized. This ensures that consistent output is produced for the same input, at the cost of reduced performance.
 
 #### Parameters
 
@@ -126,8 +132,3 @@ const obj = {
 
 stableJsonStringify(obj);  // '{"c":"bar","b":"foo","a":"baz"}'
 ```
-
-</br>
-<p align="center">
-  🔹 🔹 🔹
-</p>