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.
Merge pull request #753 from berkerpeksag/improve-installation-docs

Update installation docs to mention about pip.