Update installation docs to mention about pip.

Other changes:

- Minor markup and style changes
- Use https in URLs
- Remove the "python setup.py develop" part from the
  documentation. It's useful for development.