diff --git a/src/Talks/README.md b/src/Talks/README.md
new file mode 100644
index 00000000..e752881f
--- /dev/null
+++ b/src/Talks/README.md
@@ -0,0 +1,30 @@
+# Talks Bundle
+
+## Twig Extensions
+
+### Functions
+* `getTalks()` - get all talks
+
+    ```twig
+    {% set talks = getTalks(data.talks) %}
+    ```
+
+### Filters
+
+* `events` - get events from talks
+
+    ```twig
+    {% set talks = getTalks(data.talks)|events
+    ```
+
+* `past` - filter by past events
+
+    ```twig
+    {% set talks = getTalks(data.talks)|past
+    ```
+
+* `upcoming` - filter by current and upcoming events
+
+    ```twig
+    {% set talks = getTalks(data.talks)|upcoming
+    ```