diff --git a/tools/gen-oslo-openstack-helm/README.md b/tools/gen-oslo-openstack-helm/README.md
index d97b7478c0..01ae3f4374 100644
--- a/tools/gen-oslo-openstack-helm/README.md
+++ b/tools/gen-oslo-openstack-helm/README.md
@@ -1,2 +1,20 @@
 # gen-oslo-openstack-helm
 Oslo Config Generator Hack to Generate Helm Configs
+
+## Usage
+
+From this directory run the following commands, adjusting for the OpenStack
+project and/or branch desired as necessary.
+
+``` bash
+docker build . -t gen-oslo-openstack-helm
+docker run -it --rm \
+  -e PROJECT="heat" \
+  -e PROJECT_BRANCH="stable/newton" \
+  -e PROJECT_REPO=https://git.openstack.org/openstack/heat.git \
+  gen-oslo-openstack-helm
+```
+
+This container will then drop you into a shell, at the project root with
+OpenStack-Helm formatted configuration files in the standard locations produced
+by genconfig for the project.
diff --git a/tools/gen-oslo-openstack-helm/entrypoint.sh b/tools/gen-oslo-openstack-helm/entrypoint.sh
index 2c288cade8..9a18c2e315 100755
--- a/tools/gen-oslo-openstack-helm/entrypoint.sh
+++ b/tools/gen-oslo-openstack-helm/entrypoint.sh
@@ -19,3 +19,5 @@ source ${TOX_VENV_DIR}/bin/activate
 python /opt/gen-oslo-openstack-helm/generate.py ${GENCONFIG_FLAGS} \
     --helm_chart ${PROJECT} \
     --helm_namespace ${PROJECT}
+
+bash