Add documentation for passwords

Also minor fixes in documentation