Update documentation to cover new Twisted APIs, and improve organization of action section slightly.
Update documentation to cover new Twisted APIs, and improve organization
of action section slightly.

ScatterHQ/eliot,iffy/eliot,ClusterHQ/eliot,ScatterHQ/eliot,ScatterHQ/eliot