search

petrochenko-pavel-a / raml-js-parser2-issues

0 stars 0 forks source link

Add displayName to a specific declaration of `securitySchemes`; and remove `description` and `displayName` in `describedBy` #44

Closed VasiliyLysokobylko closed 8 years ago

VasiliyLysokobylko commented 8 years ago

In RAML 1.0 RC, the describedBy property of a security scheme has two additional properties description and displayName. My question is if we really need them to be there? A specific security scheme already has a description property and, IMHO, that makes the one in describedBy redundant. I also would understand if we move displayName up to the security scheme property as well, but it should not be in describedBy.

Happy to hear other opinions.

VasiliyLysokobylko commented 8 years ago

https://github.com/raml-org/raml-spec/issues/244

petrochenko-pavel-a commented 8 years ago

This is fixed during definition system cleanup