Add more detail to the README

Change-Id: I736f0c98faaa5fc51b4444c6e90be9ca4425d3d2
Add pbr to installation requirements

Add pbr to the list of installation requirements so that it is installed
via pip before this library is installed, instead of with easy_install.
This avoids issues like Bug #1384919, and ensures that projects that use
this library as a dependency are properly installed.

Change-Id: I6c155370dbd01fe4748d5137bdf288e8d3e1a67e
Bring doc build up to standard

Move the requirements definitions and documentation files to the
standard places used by other OpenStack projects so our doc publishing
jobs will work.

Remove the todo extension and all todo items from the documentation.

Change-Id: Iea630d827976fe517afacf4e373b3a125efff9c9
Update link to docs in README

Update the published link to the documentation in the README
file.

Change-Id: I98006a0a47c4abbd4453ed0d05d3d00ba5dc2ea3
Merge "Bring doc build up to standard"
Merge "Update link to docs in README"
Updated from global requirements

Change-Id: I9d6c88650b1f29b81aabdf1a75ab6aba15248bc2