Github user mcgilman commented on the issue:
Hey @simplesteph, thanks for the PR!
I'm not sure we can merge this in as is. I'm afraid that changing the
format of the of pre-existing values (like all time values in this case) could
break existing clients.
We do have two separate adapters for `java.util.Date`'s. The purpose of
these adapters is to create human readable values for either a timestamp or for
a date-time. The timestamps are typically used to show when something was
latest refreshed. Due to the frequency, rendering the date in these scenarios
is not necessary. The date-time adapter will additionally include the date and
is typically used for items like events.
Admittedly, I'm not super familiar with the OpenAPI spec. Rather than
changing these values, would it help if we updated the documentation to better
set the expectation of what's being returned?
If your project is set up for it, you can reply to this email and have your
reply appear on GitHub as well. If your project does not have this feature
enabled and wishes so, or if the feature is enabled but not working, please
contact infrastructure at infrastruct...@apache.org or file a JIRA ticket