sig-moonwalk icon indicating copy to clipboard operation
sig-moonwalk copied to clipboard
verified publisher icon OAI

Can the Data Types section be replaced by a reference to the format registry?

Open darrelmiller opened this issue 1 year ago • 2 comments

Instead of this paragraph, can we reference this https://spec.openapis.org/registry/format/index.html

darrelmiller avatar Jun 09 '24 18:06 darrelmiller

I think we'd have to talk about which formats are MUST/SHOULD/MAY be supported.

handrews avatar Jun 09 '24 19:06 handrews

notice few of them has no source like

  • decimal
  • int16 (vs int32 is set as OAS)
  • http date where we could put the RFC
  • decimal128
  • char
  • base64url

notice that to me decimal is highly debatable as does not belong to a standard and clear definition

is 1 a decimal ? is 1.0 a decimal what is the parsing expression that should be applied having a dot ? is 4.5e3 a decimal , but then what about 4.5345e3

as this format is mentionned as not interoperable , should it be part of an open standard ?

this may apply the rules MUST / SHOULD / MAY .... and not listed in this table , meaning what is the criteria to be in having interoperability and defined standard may be a criteria, then all that is not is custom extension

LasneF avatar Jul 23 '24 14:07 LasneF