Spectral

We have successfully applied Spectral along with custom rules to "lint" Swagger files based on the ONAP Swagger style guide!

Spectral may be found at:  https://github.com/stoplightio/spectral

Instructions to install Spectral may be found at: https://stoplight.io/p/docs/gh/stoplightio/spectral/docs/getting-started/installation.md

With Spectral, ONAP can provide our own ruleset file extending the rules used by Spectral.

This is a draft file containing ONAP Swagger Specific Style Rules for Spectral: .spectral.yml  (Note: when saving this file make sure it keeps the filename ".spectral.yml"

The Spectral CLI will look for a ruleset file called .spectral.yml or .spectral.json in the current working directory.

We could also use a different file by using the CLI option --ruleset 

Additional information on Spectral Rulesets may be found at: https://stoplight.io/p/docs/gh/stoplightio/spectral/docs/getting-started/rulesets.md

...