diff --git a/issues.adoc b/issues.adoc
new file mode 100644
index 0000000..fd4d452
--- /dev/null
+++ b/issues.adoc
@@ -0,0 +1,9 @@
+Current Issues
+--------------
+- Finish core-person in JSON Schema
+ the rest
+ of the detail
+ - Validate example json data against core-person
+  this is how we'll know if we're on track
+ - cross-check against OAI 3 syntax
+  make sure schema abides by OAI 3 rules for inclusion in API specs