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 😞