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).
Better formatting.
Merge branch 'dev' of github.com:mozilla-services/heka into dev