diff --git a/json-schema/README.md b/json-schema/README.md
new file mode 100644
index 00000000..241f69f4
--- /dev/null
+++ b/json-schema/README.md
@@ -0,0 +1,17 @@
+JSON schemas for PMM YAML files
+
+limitations:
+
+- template variables not cased for specific default file
+- template variables with keys are wildcarded
+- "position" attribute has no validation
+- "streaming" default has no validation
+- search has no validation; just accepts string
+- schedule has no validation; just accepts string
+
+TODO:
+
+- schema for collection yaml
+- schema for metadata yaml
+- schema for overlay yaml
+- schema for template yaml