Swagger-ui: Inherited model name and description ignored in the documentation
_From @prakashguru on July 5, 2017 13:32_
I have a yaml definition where a model "OrderEx" inherited using allOf from "Order". And the OrderEx is used as model for an api. The problem is the documentation shows name and description of the Order model (base) instead of OrderEx.
Am I doing something wrong? The yaml definition attached.
_Copied from original issue: swagger-api/swagger-editor#1392_
webron
All 5 comments
@owenconti can you take a look at this? You've touched the area before.
webron
on 5 Jul 2017
Also the "Example Value" shows the base model's example instead of derived.
prakashguru
on 6 Jul 2017
1+
The "Example value" issue is the most critical one. For the model name and description, one can have a workaround by writing some generic description that can actually be used throughout the inherited models
(we can live with that), but the lack of specific examples for the inherited models is actually preventing me to use the inheritance at all.
jgslima
on 10 Jul 2017
Is inheritance works in Swagger UI? Is there an example?
raderio
on 14 Aug 2017
Fixed by https://github.com/swagger-api/swagger-js/pull/1130, which should be released this week 馃帀
shockey
on 12 Sep 2017
Related issues
zilongl
路
3Comments
Deraen
路
4Comments
andrecarlucci
路
3Comments
insideshell
路
3Comments
liuya05
路
3Comments
Most helpful comment
1+
The "Example value" issue is the most critical one. For the model name and description, one can have a workaround by writing some generic description that can actually be used throughout the inherited models
(we can live with that), but the lack of specific examples for the inherited models is actually preventing me to use the inheritance at all.