Do full pass over RST docs and docstrings after datastore API revamp is completed

[pdknsk]

from gcloud import datastore
dataset = datastore.get_dataset('dataset-id-here')
# Then do other things...
query = dataset.query().kind('EntityKind')
entity = dataset.entity('EntityKind')

This doesn't work, and is in both README and official docs. It is documented in help(datastore.get_dataset) but not everyone may be aware.

>>> from gcloud import datastore
>>> dataset = datastore.get_dataset('dataset-id', email, key_path)
>>> # Now you can do things with the dataset.
>>> dataset.query().kind('TestKind').fetch()

This also makes the envorinment variables optional I think, and not mandatory as per docs. It should also be documented that key_path expects the raw p12 key and not the JSON version, unlike the environment variable.

https://googlecloudplatform.github.io/gcloud-python/datastore-api.html#cloud-datastore-in-10-seconds

[dhermes]

Thanks for the heads up.

I am in the process of pushing through some API changes and need to do a big doc update after the "new" API is in place (hopefully soon).

Do you mind if I co-opt this issue and make it an all-encompassing docs / docstrings update?

[pdknsk]

Sure, please do.

[dhermes]

This was addressed in #506 (and since we've stayed up with it).