Updated documentation based on feedback by @stevengj and @wallnuss. See https://github.com/JuliaLang/julia/pull/6221. [skip ci]