diff --git a/scripts/generate/js_api/README.md b/scripts/generate/js_api/README.md
new file mode 100644
index 000000000..d7ed19f91
--- /dev/null
+++ b/scripts/generate/js_api/README.md
@@ -0,0 +1,3 @@
+Generate the API using the es [REST api spec](https://github.com/elasticsearch/elasticsearch-rest-api-spec);
+
+to run, call `grunt run:generate_js_api`