YAML Serialization Improvements

[webron]

Not sure what the YAML serializer supports, but the following should be handled:

• String values should not be quoted unless required. For example:

      summary: "Create user"

should be

      summary: Create user

• Values that must be quotes, should use single quotes. For example:

              $ref: "#/components/schemas/User"

should be

              $ref: '#/components/schemas/User'

• Numeric keys must be quoted. For example:

      400:
          description: "User not found"

should be

      '400':
          description: "User not found"

[ralphdoe]

It seems the Response Code isn't an integer, is a natural String.

[ralphdoe]

Closed because it was treated in other PR. Yaml options #2303

[fehguy]

Hey @ralphdoe that PR is only partially fixing this issue. Namely the unchecked item above is not done.

@webron I've dug into this more and I don't know how we can support quoting numeric keys without hacking Jackson. It looks like the logic to determine if its "a number" or not is a regex and when we say "minimize quotes", it will automatically remove quotes in keys, if it passes the regex.

Here's the code that determines this:

https://github.com/FasterXML/jackson-dataformat-yaml/blob/master/src/main/java/com/fasterxml/jackson/dataformat/yaml/YAMLGenerator.java#L504-L526