security-scheme-description-exists

Overview

This rule belongs to the openapi-v3-docsgen-linting ruleset and states that:

Security Scheme Object should have a non-null and non-empty description.

Property	Value
Enabled	Yes
Maximum Severity	Information
Message	Description is missing from security scheme object.
Code	OPENAPI3DOCSGEN_L840
Type	Linting
Rule System	Semantic
Broad Category	OpenAPI Security Schemes
Products Impacted	Developer Experience Portal
Tags	documentation generation documentation docs openapi3 openapi semantic linting apimatic security scheme description

Suggested Fixes

• Add a user-friendly description for the security scheme object.

For More Information

• https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md#security-scheme-object
• https://github.com/OAI/OpenAPI-Specification/blob/main/versions/3.0.3.md
• https://docs.apimatic.io/rulesets/overview/