diff --git a/doc/json.md b/doc/json.md
new file mode 100644
index 0000000..1c2969b
--- /dev/null
+++ b/doc/json.md
@@ -0,0 +1,9 @@
+# JSON
+
+Advantages over `minetest.write_json`/`minetest.parse_json`:
+
+* Twice as fast in most benchmarks (for pre-5.6 at least)
+* Uses streams instead of strings
+* Customizable
+* Useful error messages
+* Pure Lua