diff --git a/dailyjs/recording/README.md b/dailyjs/recording/README.md
index 88a92e2..4f4a6f7 100644
--- a/dailyjs/recording/README.md
+++ b/dailyjs/recording/README.md
@@ -29,6 +29,12 @@ yarn
 yarn workspace @dailyjs/recording dev
 ```
 
+### How does this demo work?
+
+This example introduces a new [RecordingProvider](./contexts/RecordingProvider.js) context that manages listens for the various [recording events](https://docs.daily.co/reference#recording-started), counts down to begin a recording and stops a currently active recording. We also introduce a new recording modal and tray button.
+
+Remember to follow the best practises detailed in [the documentation](https://docs.daily.co/reference#recordings) to avoid lengthy or stuck recordings.
+
 ## Deploy your own on Vercel
 
 [![Deploy with Vercel](https://vercel.com/button)](https://vercel.com/new/daily-co/clone-flow?repository-url=https%3A%2F%2Fgithub.com%2Fdaily-demos%2Fexamples.git&env=DAILY_DOMAIN%2CDAILY_API_KEY&envDescription=Your%20Daily%20domain%20and%20API%20key%20can%20be%20found%20on%20your%20account%20dashboard&envLink=https%3A%2F%2Fdashboard.daily.co&project-name=daily-examples&repo-name=daily-examples)