finish the examples section in the README

Author: radix

README.rst

@@ -4,20 +4,64 @@ txEffect
 .. image:: https://travis-ci.org/python-effect/txeffect.svg?branch=master
     :target: https://travis-ci.org/python-effect/txeffect
 
+txEffect is a small library for integrating Twisted and Effect, mostly
+around Deferred<->Effect interoperation. Documentation is available at
+https://txeffect.readthedocs.org/
+
 `Effect`_ is a library for helping you write purely functional code by
 isolating the effects (that is, IO or state manipulation) in your code.
 Documentation is available at https://effect.readthedocs.org/.
 
 .. _`Effect`: https://github.com/python-effect/effect
 
-txEffect is a small library for integrating Twisted and Effect, mostly
-around Deferred<->Effect interoperation. Documentation is available at
-https://txeffect.readthedocs.org/
 
-Example
-=======
+Examples
+========
+
+Perform an Effect to get a Deferred with `txeffect.perform`_.
+
+.. _`txeffect.perform`: http://txeffect.readthedocs.org/en/latest/api/txeffect.html#txeffect.perform
+
+.. code:: python
+
+    from txeffect import perform
+    d = perform(my_dispatcher, some_effect)
+    d.addCallback(log.msg)
+
+Implement a performer for an intent that returns a Deferred with
+`txeffect.deferred_performer`_.
+
+.. _`txeffect.deferred_performer`: http://txeffect.readthedocs.org/en/latest/api/txeffect.html#txeffect.deferred_performer
+
+.. code:: python
+
+    from twisted.internet.defer import succeed
+    from txeffect import `deferred_performer`_
+
+    @deferred_performer
+    def perform_foo(dispatcher, intent):
+        return succeed('hello, world')
+
+Perform standard `Delay`_ and `parallel`_ effects using asynchronous
+implementations with `txeffect.make_twisted_dispatcher`_.
+
+.. _`Delay`: http://effect.readthedocs.org/en/latest/api/effect.html#effect.Delay
+.. _`parallel`: http://effect.readthedocs.org/en/latest/api/effect.html#effect.parallel
+.. _`txeffect.make_twisted_dispatcher`: http://txeffect.readthedocs.org/en/latest/api/txeffect.html#txeffect.make_twisted_dispatcher
+
+.. code:: python
+    from twisted.internet import reactor
+    from txeffect import `make_twisted_dispatcher`_
+
+    dispatcher = make_twisted_dispatcher(reactor)
+    p_effs = parallel([Effect(Delay(5), Effect(Delay(3), Effect(Delay(1))))])
+    perform(dispatcher, p_effs).addCallback(
+        lambda: print("5 seconds have passed!"))
+
+
+Working examples can be found at the `effect-examples`_ GitHub repo.
 
-TBD
+.. _`effect-examples`: https://github.com/python-effect/effect-examples
 
 
 Thanks