diff --git a/JSON.md b/JSON.md
new file mode 100644
index 0000000..fd34287
--- /dev/null
+++ b/JSON.md
@@ -0,0 +1,5 @@
+JSON is the "Javascript Object Notation", basically a file format for data that's suitable for easy processing by most modern web-based tools.
+
+Several tilde.club servers expose APIs essentially by spitting out JSON as their output, including (list of services here).
+
+If you're looking to parse JSON from the command line with a minimum of code, the `jq` program may be your thing. `jq` is a filter that takes JSON on standard input and produces JSON on standard output. Along the way in the middle you can do various standard sorts of file munging on a field by field basis. [Documentation is in the jq manual.](http://stedolan.github.io/jq/manual/) 
\ No newline at end of file