Add documentation about tasks

As discussed on gitter.
Add documentation about return values for tasks

As discussed on gitter
Merge pull request #25 from dfyx/patch-1

Add documentation about tasks