Documentation for .defer()

1 files changed, 11 insertions, 0 deletions

diff --git a/README.md b/README.md
index 4ab9f4a..4e53576 100644
--- a/README.md
+++ b/README.md
@@ -97,6 +97,17 @@ var id = fastdom.write(function(){});
 fastdom.clearWrite(id);
 ```
 
+### FastDom#defer(frames)
+
+Defers a job for the number of frames specified. This is useful is you have a particualrly expensive piece of work to do, and don't want it to be done with all the other work.
+
+For example; you are using third party library that doesn't expose an API that allows you split DOM read/write work, `fastdom.defer()` will push this work futher into the future and prevent it from disrupting other carefully batched work.
+
+```js
+var id = fastdom.write(function(){});
+fastdom.clearWrite(id);
+```
+
 ## Tests
 
 #### With PhantomJS