Add documentation about return values for tasks

As discussed on gitter