Overwriting descriptions on reusable objects
I have a simple type defined in a Domain used in multiple APIs: email:
type: string
maxLength: 100
description: `E-mail` address to be used
example: 'info@dcsa.org' I refer to...
Forum Discussion
chichepo as mentioned previously I have also vastly used this pattern - here is an example of overwriting the `example` value of `isShipperOwned` property
Apparently SwaggerHub accepts this pattern. I tried the same in reDocly - but here it does not work. I have not tried it - but this (mis)use of allOf also breaks code-generators. Have you tried to generate code via the SwaggerHub page? Does the code generated work?
The new OAS 3.1 allows for a "description"-sibling next to the $ref. In OAS 3.1 you can overwrite (legally) the description of a field you are referring to ($ref)
Unfortunately you still cannot overwrite the `example` property 😞
Apparently SwaggerHub accepts this pattern. I tried the same in reDocly - but here it does not work.
I was not aware about such issue on redocly. You are rigth it is, obviously, not supported.
| SwaggerHub | Redocly |
|
Regarding the code generation, in my previous response, the code was generated correctly, but "description" or "example" are not "demonstrative" attributes when talking about codegen.
I'll try something like dealing with different patterns or types.
I'll let you know.