diff --git a/schema/core-person.json b/schema/core-person.json
index e02d601..8b41e00 100644
--- a/schema/core-person.json
+++ b/schema/core-person.json
@@ -56,10 +56,12 @@
         }
       },
       "userLogon": {
-        "type": "string"
+        "type": "string",
+        "description": "same as identifier/network in Core Attribute Specification"
       },
       "institutionalId": {
-        "type": "string"
+        "type": "string",
+        "description": "same as identifier/enterprise in Core Attribute Specification"
       },
       "priorInstId": {
          "type": "array",
@@ -89,7 +91,7 @@
           }
         }
       },
-      "birthDate": {
+      "dateOfBirth": {
         "type": "string"
       },
       "email": {
@@ -108,6 +110,7 @@
     },
       "phone": {
         "type": "array",
+        "description": "same as telephoneNumber in Core Attribute Specification"
         "items": {
           "type": "object",
           "properties": {
@@ -122,6 +125,7 @@
         },
         "personalPronoun": {
           "type": "string"
+          "description": "needs to be added to Core Attribute Specification"
         }
       }
     }