diff --git a/README.md b/README.md
new file mode 100644
--- /dev/null
+++ b/README.md
@@ -0,0 +1,25 @@
+# slides
+
+## requirements
+
+- latex dependencies (debian-like system):
+
+  sudo apt install rubber texlive-latex-extra
+
+- org-mode >= 8.3 at least for proper export with allowframebreaks to work
+
+- to export in LaTeX format using the beamer class, you will need the following in your
+  Emacs configuration:
+
+    (require 'ox-beamer)
+    (add-to-list 'org-beamer-environments-extra
+                 '("picblock" "P"
+                   "\\begin{picblock}%o{%h}"
+                   "\\end{picblock}"))
+
+## how to use
+
+Inside talks-public folder, you will find sources for existing presentation. Copy one
+that matches your current new presentation then hack on it.
+
+Once ready, just go inside the folder of your new presentation and compile it (`make`).