It is not legal to have a sibling to a $ref, ever. If it works in tooling, it is a bug in the tooling. This is part of JSON schema.
> On Oct 6, 2016, at 6:40 AM, Rene Ummels <[email protected]> wrote: > > Hi, > > The following swagger contents does not seem to work. The description seems > not to be possible with $ref. > Sometimes this is needed though. > Is it really not possible? Is it a bug? Or working like this on purpose? > > properties: > deviceId: > description: some test # NOT ACCEPTED BY SWAGGER BECAUSE OF NEXT LINE > $ref: '#/definitions/DeviceId' > > > thanks, > Rene Ummels > > > -- > You received this message because you are subscribed to the Google Groups > "Swagger" group. > To unsubscribe from this group and stop receiving emails from it, send an > email to [email protected] > <mailto:[email protected]>. > For more options, visit https://groups.google.com/d/optout > <https://groups.google.com/d/optout>. -- You received this message because you are subscribed to the Google Groups "Swagger" group. To unsubscribe from this group and stop receiving emails from it, send an email to [email protected]. For more options, visit https://groups.google.com/d/optout.
