"lexicalEntries" in Sentences has a bad definition

gatebuzzgatebuzz Member
edited January 2017 in Report a bug

Throughout the JSON documentation "lexicalEntries" is defined as a reference to a single canonical definition later in the file:
"lexicalEntries": { "description": "Grammatical features, Lexical category and Sentences.", "type": "array", "items": { "$ref": "#/definitions/lexicalEntry" } }
In the case of "Sentences" you have a definition that (sadly) breaks code-generation
"lexicalEntries": { "description": "Grammatical features, Lexical category and Sentences.", "type": "array", "items": { "description": "List of found sentences.", "properties": { "grammaticalFeatures": { "description": "", "type": "string" }, "language": { "description": "", "type": "string" }, "lexicalCategory": { "description": "", "type": "string" }, "sentences": { "description": "", "type": "array" } }, "type": "object" } }
I believe that the shorter (reference) is the correct way to define things and more importantly (for me, at least) Swagger's code-generation tool actually parses the file and generates code!

Comments

Sign In or Register to comment.