docs on slide transitions
diff --git a/README.Rmd b/README.Rmd
index 3cd2722..40893a0 100644
--- a/README.Rmd
+++ b/README.Rmd
@@ -83,10 +83,6 @@
 
 * `theme` specifies the theme to use for the presentation (available themes are "default", "simple", "sky", "beige", "serif", "solarized", "blood", "moon", "night", "black", "league" or  "white").
 
-* `transition` specifies the visual effect when moving between slides. Available transitions are "default", "fade", "slide", "convex", "concave", "zoom" or "none".
-
-* `background_transition` specifies the background transition effect when moving between full page slides. Available transitions are "default", "fade", "slide", "convex", "concave", "zoom" or "none".
-
 * `highlight` specifies the syntax highlighting style. Supported styles include "default", "tango", "pygments", "kate", "monochrome", "espresso", "zenburn", and "haddock". Pass null to prevent syntax highlighting.
 
 * `center` specifies whether you want to vertically center content on slides (this defaults to false).
@@ -99,11 +95,40 @@
     output:
       revealjs::revealjs_presentation:
         theme: sky
-        transition: fade
         highlight: pygments
         center: true
     ---
 
+## Slide Transitions
+
+You can use the `transition` and `background_transition` optoins to specify the global default slide transition style:
+
+* `transition` specifies the visual effect when moving between slides. Available transitions are "default", "fade", "slide", "convex", "concave", "zoom" or "none".
+
+* `background_transition` specifies the background transition effect when moving between full page slides. Available transitions are "default", "fade", "slide", "convex", "concave", "zoom" or "none".
+
+For example:
+
+    ---
+    output:
+      revealjs::revealjs_presentation:
+        transition: fade
+    ---
+
+
+You can override the global transition for a specific slide by using the data-transition attribute, for example:
+
+    ## Use a zoom transition {data-transition="zoom"}
+    
+    ## Use a faster speed {data-transition-speed="fast"}
+    
+You can also use different in and out transitions for the same slide, for example:
+
+    ## Fade in, Slide out {data-transition="slide-in fade-out"}
+    
+    ## Slide in, Fade out {data-transition="fade-in slide-out"}
+
+
 ## Slide Backgrounds
 
 Slides are contained within a limited portion of the screen by default to allow them to fit any display and scale uniformly. You can apply full page backgrounds outside of the slide area by adding a data-background attribute to your slide header element. Four different types of backgrounds are supported: color, image, video and iframe. Below are a few examples.