Updated documentation

* Describe func!(x) convention for functions which modify their arguments
* Add brief introduction to standard library
* Fix up a few links
Merge pull request #4017 from JuliaLang/kms/func_mod_arg_doc

Updated documentation (fixes #4013)