diff --git a/README.md b/README.md
index 08e5e2a9dc..9cdbab23c9 100644
--- a/README.md
+++ b/README.md
@@ -53,6 +53,20 @@ $ make generate
 $ cat output/schema/schema.json
 ```
 
+## How to generate the OpenAPI representation
+
+Follow the steps to generate the JSON representation, then:
+
+```
+# Generate the OpenAPI representation
+$ make transform-to-openapi
+
+# Apply fixes
+$ make overlay-docs
+
+# The generated output can be found in ./output/openapi/
+```
+
 ## Make Targets
 
 ```