How should parameter examples be written?

[chrisradek]

I'm trying to understand whether or not to apply serialization to parameter examples. If I'm following #3041 and the changes added to 3.0.4, it looks like parameter examples should be serialized according to this table:
https://spec.openapis.org/oas/v3.0.4.html#style-examples

So then I'd have parameters specified like this:

parameters:
  - name: foo
    in: query
    required: true
    schema:
      type: string
      enum:
        - blue
    explode: false
    example: ?foo=blue # Instead of "blue"
  - name: colors
    in: query
    required: true
    explode: false
    schema:
      type: array
      items:
        type: string
    example: "?color=blue,black,brown" # Instead of ["blue", "black", "brown"]

However this seems to cause problems for the tooling I've tested with (swagger-ui, spectral, vacuum) and seems to contradict documentation around parameters elsewhere (where the serialization:
https://swagger.io/docs/specification/v3_0/describing-parameters/#parameter-examples

I work on a tool that generates Open API and am adding support for emitting parameter examples, but came across issues around tooling support as part of validation. I'm curious if there are any tools that do work with the serialized examples.