schema-generator

README

OpenAPI 3.0 Schema Generator

This directory contains a support tool that reads (scrapes) the Markdown text specification for OpenAPI 3.0 and builds a corresponding JSON schema.

It also contains "3.0.1.md", a local copy of the OpenAPI specification.

Disclaimer

This does not generate the official OpenAPI 3.0 JSON Schema, which at the time of this commit, does not exist.

Documentation

Overview

schema-generator is a support tool that generates the OpenAPI v3 JSON schema. Yes, it's gross, but the OpenAPI 3 spec, which defines REST APIs with a rigorous JSON schema, is itself defined with a Markdown file. Ironic?