New rustdoc changes and how to fix up your docs

[steveklabnik]

https://blog.guillaume-gomez.fr/articles/2017-09-18+New+rustdoc+rendering+common+errors