diff --git a/src/chats/README.md b/src/chats/README.md
new file mode 100644
index 0000000..8533511
--- /dev/null
+++ b/src/chats/README.md
@@ -0,0 +1,24 @@
+# Chat System Documentation
+
+For now, see chat.rs for the source code and the individual YAML files for examples.
+
+# Known bugs
+## Only Ifs
+
+```
+- some choice:
+    - if $a:
+        - answer 1
+    - if $b:
+        - answer 2
+```
+
+This is currently broken. Instead do this:
+
+```
+- some choice:
+    - if $a:
+        - answer 1
+        - goto: somelabel
+    - answer 2
+```