Remove outdated sample JSON config file, spruce up and add links to `pipeline`
package top level docs so we look better on the godoc.org site
(http://godoc.org/github.com/mozilla-services/heka/pipeline).