René's URL Explorer Experiment

{"@context":"https://schema.org","@type":"DiscussionForumPosting","headline":"Do full pass over RST docs and docstrings after datastore API revamp is completed","articleBody":"``` Python\nfrom gcloud import datastore\ndataset = datastore.get_dataset('dataset-id-here')\n# Then do other things...\nquery = dataset.query().kind('EntityKind')\nentity = dataset.entity('EntityKind')\n```\n\nThis 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.\n\n``` Python\n\u003e\u003e\u003e from gcloud import datastore\n\u003e\u003e\u003e dataset = datastore.get_dataset('dataset-id', email, key_path)\n\u003e\u003e\u003e # Now you can do things with the dataset.\n\u003e\u003e\u003e dataset.query().kind('TestKind').fetch()\n```\n\nThis 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.\n\nhttps://googlecloudplatform.github.io/gcloud-python/datastore-api.html#cloud-datastore-in-10-seconds\n","author":{"url":"https://github.com/pdknsk","@type":"Person","name":"pdknsk"},"datePublished":"2014-12-28T20:05:44.000Z","interactionStatistic":{"@type":"InteractionCounter","interactionType":"https://schema.org/CommentAction","userInteractionCount":3},"url":"https://github.com/469/google-cloud-python/issues/469"}