diff --git a/README.md b/README.md
index 13876fab..959957d4 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,23 @@
 # steerer
 
-service mesh steerer
+Istio progressive rollout gated by Prometheus HTTP success rate metric
+
+### Usage
+
+Create a test namespace:
+
+```bash
+kubectl apply -f ./artifacts/namespace/
+```
+
+Create GA and canary deployments, services and Istio virtual service:
+
+```bash
+kubectl apply -f ./artifacts/workloads/
+```
+
+Start rollout:
+
+![rollout-cli](docs/screens/rollout-cli-output.png)
+
+
diff --git a/docs/screens/rollout-cli-output.png b/docs/screens/rollout-cli-output.png
new file mode 100644
index 00000000..3bc88cb1
Binary files /dev/null and b/docs/screens/rollout-cli-output.png differ