`schema with allOf combinator containing only one item should be replaced with the item directly` should not fire when overriding description in OAS 3.0

[scottbusche-usps]

When working in OAS version 3.0 and you want to use the same reference, but override the description, you have to do something like this:

field1:
  $ref: '#/components/schemas/field1'
field1b:
  description: I have the same structure as field1, but I am different
  allOf:
    - $ref: '#/components/schemas/field1'

This will cause the schema with allOf combinator containing only one item should be replaced with the item directly rule to trigger. I don't believe it should, as in OAS 3.0, you cannot override a description of a $ref without using the allOf field. In OAS 3.1+ it makes complete sense to fire, since you can directly override the description.

[LasneF]

@daveshanley i am not 100 % of the validaty of the rules , as the all of pattern combining a common and specific part is quite valid, it is "just" a question of style could be downgraded to info

Dog :
type : object
description : ZZ
allOf :

• $ref:"#components/schemas/annimal"
  Properties
  bark :
  type : String

[daveshanley]

I have added a condition to check for this case in the no-unnecessary-combinator rule.

will be available in the next release.

[daveshanley]

fixed in v0.20.5