diff --git a/README.md b/README.md
new file mode 100644
index 0000000..2a5a6f0
--- /dev/null
+++ b/README.md
@@ -0,0 +1,4 @@
+API docs written in swagger/redocly format.
+
+* API docs can be rendered into stand-alone HTML with: `npm start`.
+* API text can be linted with `npm test`.