Updated documentation based on feedback. See https://github.com/JuliaLang/julia/pull/6221