diff --git a/README.md b/README.md
index b3609f433..90491cf87 100644
--- a/README.md
+++ b/README.md
@@ -4,6 +4,9 @@ The documentation built with [Docusaurus](https://docusaurus.io).
 
 The search is implemented using [DocSearch](https://docsearch.algolia.com).
 
+The OpenAPI documentation is generated using
+[PaloAltoNetworks docusaurus-openapi-docs plugin](https://github.com/PaloAltoNetworks/docusaurus-openapi-docs).
+
 ## Running locally
 
 1. Install the dependencies
@@ -16,8 +19,9 @@ npm install
 npm run start
 ```
 
-3. For production ready build use the next command:
+3. For production ready build use the next commands:
 ```bash
+npm run gen-all
 npm run build
 ```
 
diff --git a/package.json b/package.json
index 20e81a1e6..e07367110 100644
--- a/package.json
+++ b/package.json
@@ -4,7 +4,7 @@
   "description": "ReportPortal Documentation",
   "scripts": {
     "docusaurus": "docusaurus",
-    "start": "docusaurus start",
+    "start": "npm run re-gen && docusaurus start",
     "build": "docusaurus build",
     "lint": "eslint src/**/*.{js,jsx}",
     "format": "npm run lint -- --fix",