diff --git a/README.md b/README.md
index 77e009ccace6629d6887f76a85882c04cb38bf3c..b3d2494cc07eb9579154132a47b82dfd1fdb1678 100644
--- a/README.md
+++ b/README.md
@@ -50,6 +50,11 @@ manifest files is contained in Dhall type definitions:
 JSON schema files for upstream and downstream APIs are available:  
 - JSON/YAML schemas: `resources/schemas/{upstream-*,downstream}.json`
 
+### notebooks
+
+Tutorial notebooks for configuration and upstream python bindings are available
+in the `notebooks` folder.
+
 ## Development
 
 - building: `make`