diff --git a/README.md b/README.md
index 90a5671..f8533bf 100644
--- a/README.md
+++ b/README.md
@@ -4,6 +4,9 @@ closer to the stars. application for predictive sky brightness over discretized
 
 ## getting started
 
+this will spin up the process of the prediction producer container repeatedly asking the api server for sky brightness
+measurements across all [resolution 0 h3 cells](https://h3geo.org/docs/core-library/restable/).
+
 ```shell
 docker-compose up --build
 ```