Complete first draft

example/README.md

@@ -0,0 +1,13 @@
+# The Speakeasy Bar API
+
+## Introduction
+
+TODO: Introduction to the Speakeasy Bar API example
+
+## Installing The Speakeasy Bar API
+
+TODO: Installing The Speakeasy Bar API
+
+## Overview Of The Speakeasy Bar API
+
+TODO: Overview Of The Speakeasy Bar API, discuss endpoints and components one by one with inline snippets.

glossary/README.md

@@ -0,0 +1,11 @@
+# OpenAPI Glossary
+
+TODO: Write short definitions for OpenAPI terms, link to our reference docs. Examples:
+
+## OpenAPI specification
+
+## OpenAPI document
+
+## JSON-Schema
+
+## SDK generator

guides/README.md

@@ -0,0 +1,20 @@
+# OpenAPI Guides
+
+## Introduction
+
+TODO: OpenAPI Guides Introduction
+
+## Guides
+
+TODO: Guides, categorised/structured according to e.g. documentation, SDKs, CI/CD, etc.
+
+Some examples:
+
+- How to add a webhook using OpenAPI.
+- How to add a list as a path parameter in OpenAPI.
+- Add SDK generation to your CI/CD workflows.
+- Lint and edit documentation strings in your OpenAPI documents.
+- How to generate API documentation using Redoc.
+- How to add Redoc-generated OpenAPI documentation to Docusaurus.
+- How to validate your OpenAPI document as part of CI/CD.
+- etc.