pretty up the docs (bug docs)
Merge pull request #701 from andymckay/docs

pretty up the docs (bug docs)