[Bug]: There is no way to set the description for OpenAPI responses openapi-emitter [emitter:openapi3]

[AngelEVargas]

Describe the bug

Documentation strings added to the TypeSpec model or attributes of the response are not reflected in the generated OpenAPI responses description. Instead, the descriptions added by the emitter are some standard ones.

@doc("How to replace standard description with this one?")
model NotAuthenticatedError extends Errors.Error {
  @doc("Or maybe with this other?")
  @statusCode
  _: 401
}

Generates:

       '401':
          description: Access is unauthorized.
          content:
            application/json:
              schema:
                $ref: '#/components/schemas/NotAuthenticatedError'

cc @mario-guerra

Reproduction

Playground

Checklist

• Follow our Code of Conduct
• Check that there isn't already an issue that request the same bug to avoid creating a duplicate.
• Check that this is a concrete bug. For Q&A open a GitHub Discussion.
• The provided reproduction is a minimal reproducible example of the bug.

[mario-guerra]

@timotheeguerin is it possible to override the default operation description?

[chrisradek]

I believe this is a duplicate of #3664 which is also marked as a bug.

Currently you'd need either an empty model, or explicitly define the body/bodyRoot parameter like this: playground

[AngelEVargas]

Thank you @chrisradek that is helpful

[mario-guerra]

@AngelEVargas closing this issue as a duplicate.