doc: Update README.rst with correct installation and contibution info
doc: Update README.rst with correct installation and contibution info

Now that we are on PyPI, users can install from there. I also took
the opportunity to link to our new contributor guide.

Change-Id: Ifbdd07247a1e4865d02539f23be103c86414b7a9

openstack/python-zaqarclient