diff --git a/README.md b/README.md
new file mode 100644
index 0000000..3078b65
--- /dev/null
+++ b/README.md
@@ -0,0 +1,18 @@
+# All The Things
+
+**It's a suggest mode for both pages *and* entries.**
+
+## Installation
+
+Copy the `AllTheThings` folder into `site/addons/`, and then use as a mode in your suggest field!
+
+## Usage
+
+**Example Fieldset**
+```yaml
+fields:
+  related_links:
+    type: suggest
+    display: Related Links
+    mode: AllTheThings
+```
\ No newline at end of file