pretty up the docs (bug docs)

for @chuckharmston this covers a few things, I got a bit carried away, but I think the topics/api/misc.html is better and how we could go about using this elsewhere in the docs. You'll probably want to check out this branch and build it to see the goodness.