Add README, commit generated OpenAPI schema

Author: swallez

openapi-converter/README.md

@@ -3,5 +3,6 @@
 Workspace members:
 
 * [`clients_schema`](./clients_schema/): a Rust implementation of the [Elasticsearch specification schema](https://github.com/elastic/elasticsearch-specification/blob/main/compiler/src/model/metamodel.ts) metamodel.
-* [`openapi_to_clients_schema`](./openapi_to_clients_schema): translate an OpenAPI specification to an Elasticsearch 
+* [`clients_schema_to_openapi`](./clients_schema_to_openapi): conversion of the `schema.json` format to OpenAPI. Supersedes [elasticsearch-openapi](https://github.com/elastic/elasticsearch-openapi).
+* [`openapi_to_clients_schema`](./openapi_to_clients_schema): experimental, translate an OpenAPI specification to an Elasticsearch 
   schema that can be used as input for code generation.

openapi-converter/clients_schema_to_openapi/README.md

@@ -0,0 +1,17 @@
+# Schema.json to OpenAPI converter
+
+This project provides a utility to convert the [schema.json](../../output/schema) file representing the Elasticsearch API specification to OpenAPI version 3.0.3.
+
+The conversion pipeline is the following:
+
+```mermaid
+flowchart LR
+    ts[TypeScript API]
+    schema[schema.json]
+    openapi[OpenAPI]
+    
+    ts --> schema
+    schema --> openapi
+```
+
+This is still a work in progress. The OpenAPI specification generated from the current `schema.json` can be found in the [output/openapi](../../output/openapi) directory. 

openapi-converter/clients_schema_to_openapi/src/lib.rs

@@ -30,7 +30,7 @@ pub fn convert_schema_file(path: impl AsRef<Path>, endpoint_filter: fn(e: &Endpo
     }
 
     let openapi = convert_schema(&model, endpoint_filter)?;
-    //serde_json::to_writer_pretty(BufWriter::new(out), &openapi)?;
+    serde_json::to_writer_pretty(BufWriter::new(out), &openapi)?;
     Ok(())
 }
 

openapi-converter/clients_schema_to_openapi/src/main.rs

@@ -22,7 +22,8 @@ fn main() -> anyhow::Result<()> {
         "../output/schema/schema-no-generics.json",
         |e| true,
         //|e| e.name == "search",
-        std::io::stdout()
+        std::fs::File::create("../output/openapi/elasticsearch-openapi.json")?
+        //std::io::stdout()
     )?;
 
     Ok(())