Will this include a "how to use pipetask to execute pipelines" or should that be a separate document?

Here is the review we talked about. You have looked at this once a while ago, and indeed the pull request is still up there. But it has been reworked and converted to rst. If you could review the rst version I would appreciate it. I have not deleted the old markdown version yet, as I have shared the github link around and dont want to remove it until the rst is up.

I've finished my review. The summary is https://github.com/lsst/pipe_base/pull/102#pullrequestreview-562972083

As I said there, so long as the basic rst syntax issues are taken care of and the document compiles with the full stack (following the instructions at https://developer.lsst.io/stack/building-pipelines-lsst-io-locally.html) then you can go ahead and merge this without necessarily taking care of all my suggested edits (if your time doesn't permit). We can always revisit the document as time goes on and continue to improve it as more pipeline task documentation is created.

Nate Lust there's a huge amount of content on this ticket that people can't see. How do we get it unblocked?

There are things with this documentation that will need to be addressed over time, but enough of the issues were addressed that it should not wait to be perfect. I fixed a lot, and made sure it built correctly with sphinx and merged it in.