info-defined
Since 0.9.0 · In the rulesets: Recommended at error, Strict at error, All at error
This rule checks whether the info object of a Swagger 2.0 document provides a description and a version.
Rule details
The info object is the first thing readers of an API see. Besides the mandatory title, it should explain what the application does and which version of the API is being described.
The info-defined rule reports:
Info description is missing or emptywheninfo.descriptionis missing or empty,Info version is emptywheninfo.versionis an empty string.
The title is required by the Swagger specification itself and is not checked by this rule.
The OpenAPI and AsyncAPI linters have rules of the same name, info-defined and info-defined.
Examples
Good.
swagger: '2.0'
info:
title: Pet Store
version: 1.0.0
description: Manages the pets of a shelter and their adoptions.
paths: {}
Bad. The document does not explain what the API does, and its version is empty.
swagger: '2.0'
info:
title: Pet Store
version: ''
paths: {}
Turn it off or change its severity
In apigenie.yaml, off turns the rule off and warning or error sets its severity; a rule with options takes the severity and the options as a pair, [warning, options]. lint.swagger has the details.
commands:
lint:
swagger:
rules:
info-defined: off