experience-versioning.html

Explicit, predictable versioning so changes don't break consumers.

28 rules experience: versioning 27 inlined · 1 from the engine

Run this ruleset

Lint any matching artifact against this ruleset with the Spotlight CLI:

npm i -g @spotlight-rules/spotlight-cli
spotlight lint api.yaml \
  --ruleset https://apicommons.org/assets/rulesets/experience-versioning.spotlight.yaml

Or load it into the browser validator, post it to the HTTP API, or wire it into a CI gate. 1 of these rules are the engine's built-ins (they come with spotlight:*); the other 27 are inlined in the file below.

Ruleset definition

Download YAML 

Loading…

Rules in this ruleset (28)

Skill Version Semver Agent Skill
API Property Require Versioning APIs.json
Info APIs JSON Specification Version Format APIs.json
Schema Include API Lifecycle APIs.json
Schema Include Change Log APIs.json
Schema Include Deprecation Policy APIs.json
Schema Include Version Comparison APIs.json
Asyncapi Latest Version AsyncAPI engine
Info Asyncapi Version Semver AsyncAPI
Info MCP Protocol Version Dated MCP
Info MCP Version Semver MCP
Info Require Protocol Version MCP
Info Require Version MCP
Info Require Openapi Version 3x OpenAPI
Info Require Version OpenAPI
Info Version Must Be Semver OpenAPI
Info Version Must Use Semver OpenAPI
Info Version Semantic And Stable OpenAPI
Operation Deprecated Require Description OpenAPI
Parameter Deprecated Require Description OpenAPI
Path Include Version OpenAPI
Path No Version Segment OpenAPI
Path URI Versioning Single Version OpenAPI
Response Deprecated Operation Deprecation Header OpenAPI
Response Deprecated Operation Sunset Header OpenAPI
Schema Deprecated Property Require Description OpenAPI
Server URL Include Version OpenAPI
Tag No Version Info OpenAPI

← All experience rulesets