search

zalando / intellij-swagger

A plugin to help you easily edit Swagger and OpenAPI specification files inside IntelliJ IDEA
https://plugins.jetbrains.com/plugin/8347
MIT License
1.17k stars 74 forks source link

Property "description" not allowed (when it is $ref sibling) #315

Open neopaf opened 3 years ago

neopaf commented 3 years ago

(thanks for very useful plugin!!) version: 1.0.28

Input:

          "policyRuleSpec": {
            "$ref": "#/components/schemas/PolicyRuleSpecRef",
            "description": "some text"
          },

Intellij underlines description line red, suggests to remove it, and claims that

Property "description" not allowed.

I'm not sure who and how validates the document, status line has it "No JSON schema".

According to https://swagger.io/docs/specification/using-ref/

All siblings of $ref must be ignored.

Is this message "not allowed" related to Swagger plugin?