Merge pull request #457 from cds-hooks/issue/remove-openapi-from-spec

Remove the OpenAPI model from the specification (fixes #354).

Author: brynrhodes

docs/index.md

@@ -40,4 +40,8 @@ materials (*app link card*). A user sees these cards — one or more of each typ
 
 ## Try it!
 
-You can try CDS Hooks in our Sandbox at **[http://sandbox.cds-hooks.org](http://sandbox.cds-hooks.org)**
+You can try CDS Hooks in our Sandbox at [http://sandbox.cds-hooks.org](http://sandbox.cds-hooks.org)
+
+An [OpenAPI Specification](https://www.openapis.org/) (formally known as the Swagger Specification) interface of CDS Hooks is available. Using the CDS Hooks OpenAPI specification, you can generate client or server code to help you get started with your implementation. You can download the [API specification](https://github.com/cds-hooks/api) and view it online via the [Swagger Editor](http://editor.swagger.io/?url=https://raw.githubusercontent.com/cds-hooks/api/master/cds-hooks.yaml).
+
+CDS Hooks implementers are not required to use the OpenAPI Specification interface of CDS Hooks.

docs/specification/1.0-api.yaml

@@ -10,12 +10,6 @@ The CDS Hooks specification describes the RESTful APIs and interactions to integ
 ### Conformance Language
 The key words "MUST", "MUST NOT", "REQUIRED", "SHALL", "SHALL NOT", "SHOULD", "SHOULD NOT", "RECOMMENDED", "MAY", and "OPTIONAL" in this specification are to be interpreted as described in [RFC2119](https://tools.ietf.org/html/rfc2119).
 
-## Open API Specification
-
-An [Open API Specification](https://www.openapis.org/) (formally known as the Swagger Specification) interface of CDS Hooks is available. The open source Open API Specification defines a programming language-agnostic method to describe a RESTful API like CDS Hooks. The Open API Specification is used by many projects and is supported by CDS Hooks for the benefit of implementers.
-
-CDS Hooks implementers are not required to use the Open API Specification interface of CDS Hooks. You can download the [API specification](/specification/1.0-api.yaml) and view it online via the [Swagger Editor](http://editor.swagger.io/?url=https://raw.githubusercontent.com/cds-hooks/docs/master/docs/specification/1.0-api.yaml).
-
 ## CDS Hooks Anatomy
 
 This specification describes a ["hook"](http://en.wikipedia.org/wiki/Hooking)-based pattern for invoking