run_pipeline and docs

[ahalterman]

This is code related to getting run_pipeline working (closes #10). It also fixes some whitespace issues and improves the documentation.

Before merging, need to:

• [x] get the pipeline test code working
• [x] update the documentation for the JSON-based workflow