Add Spec Validation (#117)

* Add first version of spec validation article.

* Update validate-spec.md

* Rename validate-spec -> openapi-validation. Update OAS -> OpenAPI. Add callout regarding v3 support. Add related section at bottom.

* use a blockquote + latest markdown annotation idea
This commit is contained in:
Ross McDonald
2018-02-01 12:33:38 -06:00
committed by Robert Wallach
parent 9708c53ca7
commit 3d17366009
2 changed files with 14 additions and 1 deletions

View File

@@ -0,0 +1,14 @@
# OpenAPI Validation
![](../../assets/gifs/file-validation-oas-spec.gif)
OpenAPI validation is the process of verifying the underlying OpenAPI file syntax by making sure it conforms to the [OpenAPI Specification requirements](https://github.com/OAI/OpenAPI-Specification#the-openapi-specification) provided by the [OpenAPI Initiative](https://www.openapis.org/). Stoplight immediately validates any changes done to a spec to ensure they are in the correct format prior to being saved.
<!-- theme: info -->
> Stoplight currently supports the OpenAPI v2 specification. We are working on support for OpenAPI v3, and should have more information in the coming months.
***
**Related**
* [File Validation](../editor/file-validation.md)

View File

@@ -1 +0,0 @@