Updating documentation for data format support

[sameerz]

This is a first pass at updating the documentation to warn users about unsupported data formats.

@andygrove if we have any more specific information about which formats are supported but can produce incorrect results for invalid inputs, it would be good for us to clarify that in the docs as well.

Fixes #2003

[andygrove]

@sameerz I'm no longer sure which formats can produce incorrect results because there were a number of improvements since this documentation was originally written. However, @viadea did run into one example (I think) that led to this issue being filed.

[andygrove]

@sameerz I'm no longer sure which formats can produce incorrect results because there were a number of improvements since this documentation was originally written. However, @viadea did run into one example (I think) that led to this issue being filed.

Actually, that isn't correct. @viadea was using an unsupported format, not a format that can produce incorrect results.

[andygrove]

LGTM

[sameerz]

@sameerz I'm no longer sure which formats can produce incorrect results because there were a number of improvements since this documentation was originally written. However, @viadea did run into one example (I think) that led to this issue being filed.

Actually, that isn't correct. @viadea was using an unsupported format, not a format that can produce incorrect results.

@andygrove is it still accurate to say that "some are supported but can produce incorrect results for invalid inputs" or should I update the document?

[sameerz]

@andygrove is going to investigate sql.incompatibleDateFormats and either remove it or provide more specific information about incompatible formats for the documentation. Putting this into a draft state for the time being.

[sameerz]

@andygrove please re-review

[sameerz]

build

[pxLi]

build

[andygrove]

Thanks, Sameer. I think this is much clearer now.