Update documentation for JSR310 and Joda dates

See #1021 #536 #893
There is a way to correctly map the "Date" and "DateTime" types to their corresponding swagger types:

Substitute "Date" types (java.util.LocalDate, org.joda.time.LocalDate) by java.sql.Date
Substitute "DateTime" types (java.util.ZonedDateTime, org.joda.time.LocalDateTime, ...) by java.util.Date

docket
.directModelSubstitute(LocalDate.class, java.sql.Date.class)
.directModelSubstitute(LocalDateTime.class, java.util.Date.class)

The current doc suggests to subtitute by String but this loses the information on the format.

Provide feedback