spectral:oas warn off by default

oas2-parameter-description

Parameter objects must have "description".

Applies to
description
Selects
$..parameters[?(@ && @.in)]
Function
truthy
Specs
OpenAPI 2.0

Use it

This rule ships with OpenLint in spectral:oas. It's off by default, so turn it on by name:

extends: spectral:oas
rules:
  oas2-parameter-description: true

Definition

As defined in @openlint/openlint-rulesets. Functions show by name.

oas2-parameter-description:
  description: Parameter objects must have "description".
  recommended: false
  formats:
    - OpenAPI 2.0 (Swagger)
  given: '$..parameters[?(@ && @.in)]'
  then:
    field: description
    function: truthy

About this rule

Parameter objects should have a description.

Sources