add some docs
Merge pull request #397 from twitter/docs/richpipe

add some docs