Clean up Stoplightisms #6
philsturgeon
started this conversation in
General
Replies: 0 comments
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Uh oh!
There was an error while loading. Please reload this page.
Here's a list of rules that ended up in
spectral:oasbecause a) I happened to put that into Speccy before they copied it, or b) to help you make your OpenAPI look better in Stoplight.None of these rules any anything to do with basic OAS validity and as such I would love for them to be removed from any new core OAS package (e.g.
openlint:openapi) but of course kept around in some legacy form.Some linters such as Vacuum hide this behind "strict" mode, but what does that mean? It's not strictly more valid, its just stuff I was getting moaned at for adding at WeWork and I wanted to tuck it away behind a Gold Star Good Dog mode to get people onto the Speccy pipeline at all, then ratched up later.
Each of those rules could have a new home in themed rulesets.
operation-singular-tagthat was just a lack of creativity in Stoplight for what to do with multiple tags, and the new OAS 3.2tags.[].kindkeyword resolves that nicely. With multiple kinds of tag people are more likely to use them more, so we should ditch this anyway.All reactions