docs(api): improve explanation of extractable dates

Author: umarbutler

openapi.yaml

@@ -2260,13 +2260,14 @@ components:
       - person
       - mentions
       title: ILGSv1 Date
-      description: 'A date identified in a document belonging to one of the following
-        types: `creation`, `signature`, `effective`, `expiry`, `delivery`, `renewal`,
-        `payment`, `birth`, or `death`.
+      description: 'An array of dates identified in the document belonging to one
+        of the following types: `creation`, `signature`, `effective`, `expiry`, `delivery`,
+        `renewal`, `payment`, `birth`, or `death`.
 
 
-        Only Gregorian dates between the years 1000 and 9999 (inclusive) fitting into
-        one of the supported date types are extractable.'
+        Only full Gregorian dates (i.e., including a day, month, and year) between
+        the years 1000 and 9999 (inclusive) fitting into one of the supported date
+        types are extractable.'
       examples:
       - value: '2028-01-01'
         type: signature
@@ -3778,8 +3779,9 @@ components:
             `delivery`, `renewal`, `payment`, `birth`, or `death`.
 
 
-            Only Gregorian dates between the years 1000 and 9999 (inclusive) fitting
-            into one of the supported date types are extractable.'
+            Only full Gregorian dates (i.e., including a day, month, and year) between
+            the years 1000 and 9999 (inclusive) fitting into one of the supported
+            date types are extractable.'
           examples:
           - - value: '2028-01-01'
               type: signature