Chore: Update README

Author: dmaccormack

README.md

@@ -1,20 +1,31 @@
-# JSON->URL
-[![License: MIT](https://img.shields.io/github/license/jsonurl/jsonurl-js.svg?label=License)](https://opensource.org/licenses/MIT)
+# JSON→URL
+[![License: MIT](https://img.shields.io/github/license/jsonurl/jsonurl-js.svg?label=License)][license]
 
 ## About
-RFC8259 describes the JSON data model and interchange format, which is widely
+[RFC8259][RFC8259] describes the JSON data model and interchange format, which is widely
 used in application-level protocols including RESTful APIs. It is common for
-applications to request resources via the HTTP POST method, with JSON entities,
-however, POST is suboptimal for requests which do not modify a resource's
-state. JSON->URL defines a text format for the JSON data model suitable for use
-within a URL/URI (as described by RFC3986).
+applications to request resources via the HTTP POST method, with JSON entities.
+However, POST is suboptimal for requests which do not modify a resource's
+state. JSON→URL defines a text format for the JSON data model suitable
+for use within a [URL][RFC1738]/[URI][RFC3986].
 
 ## The JavaScript API
-JSON->URL is available as a commonjs module (suitable for use in Node), ES6
+JSON→URL is available as a commonjs module (suitable for use in Node), ES6
 module, or a script that may be used directly in a browser. The API is the
 same for all three.
 ```js
 let p = new JsonURL();
 let value = p.parse( "(Hello:World!)" );
 ```
-There are options available, but that's all you need to get started.
+There are options available, but that's all you need to get started.
+
+## Security
+The parser is designed to parse untrusted input. It supports limits on
+the number of parsed values and depth of nested arrays or objects.
+When the limit is exceeded an Error is thrown, and sane limit values are
+set by default.
+
+[RFC8259]: https://tools.ietf.org/html/rfc8259
+[RFC3986]: https://tools.ietf.org/html/rfc3986
+[RFC1738]: https://tools.ietf.org/html/rfc1738
+[license]: https://opensource.org/licenses/MIT