Update api docstrings to match guidelines

Per http://docs.openstack.org/developer/hacking/
and http://www.python.org/dev/peps/pep-0257/

Change-Id: I33f03d784996e298ebd94aabec93e5083b5df840
Merge "Update api docstrings to match guidelines"