rustdoc: Document what's going on throughout#9704

bors merged 1 commit intorust-lang:masterrust-lang/rust:masterfrom

alexcrichton:rustdoc-commentsalexcrichton/rust:rustdoc-commentsCopy head branch name to clipboard