diff --git a/docs/examples/jupyter_ui.md b/docs/examples/jupyter_ui.md
new file mode 100644
index 0000000..98d6e8c
--- /dev/null
+++ b/docs/examples/jupyter_ui.md
@@ -0,0 +1 @@
+--8<-- "examples/jupyter_ui/README.md"
diff --git a/examples/jupyter_ui/README.md b/examples/jupyter_ui/README.md
index b69f7cd..4c6fdc5 100644
--- a/examples/jupyter_ui/README.md
+++ b/examples/jupyter_ui/README.md
@@ -2,3 +2,9 @@
 
 
 An attempt at using [jupyterlite](https://jupyter.org/try-jupyter/lab/) as an interactive development frontend.
+
+## Quick start
+
+* start `data_generator.py` to produce mock messages
+* start `listener.py` to receive messages
+* TODO: connect to ws from UI client