Some edits to READMEs

x-pack/plugins/ingest_manager/common/openapi/README.md

@@ -1,7 +1,10 @@
 ## The `openapi` folder
 
-This folder contains your entrypoint `openapi.yaml`.
+ * `spec_entry.json` is the version which links to the various files on disk.
+ * `spec_bundled.json` is the resolved output of that entry & other files in one file. It's currently generated with
 
-That file contains references to the entire API definition.
-
-* [Paths](paths/README.md): this defines each endpoint.  A path can have one operation per http method.
+    `npx swagger-cli bundle spec_entry.json -o spec_bundled.json`
+ * [Paths](paths/README.md): this defines each endpoint.  A path can have one operation per http method.
+* [Components](components/README.md): Reusable components like [`schemas`](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#schemaObject),
+  [`responses`](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#responseObject)
+  [`parameters`](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#parameterObject), etc

x-pack/plugins/ingest_manager/common/openapi/components/README.md

@@ -7,8 +7,8 @@ Reusable components
   - `parameters` - reusable [Parameter Objects](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#parameterObject)
   - `examples` - reusable [Example Objects](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#exampleObject)
   - `headers` - reusable [Header Objects](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#headerObject)
-  - `requestBodies` - reusable [Request Body Objects](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#requestBodyObject)
+  - `request_bodies` - reusable [Request Body Objects](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#requestBodyObject)
   - `links` - reusable [Link Objects](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#linkObject)
   - `callbacks` - reusable [Callback Objects](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#callbackObject)
-  - `securitySchemes` - reusable [Security Scheme Objects](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#securitySchemeObject)
+  - `security_schemes` - reusable [Security Scheme Objects](https://github.com/OAI/OpenAPI-Specification/blob/master/versions/3.0.2.md#securitySchemeObject)
 * Filename of files inside the folders represent component name, e.g. `Customer.yaml`