Improve docstrings for Workflow API

@stephensanchez, @wedaly: Just adding some docstrings.