Generate most non-appengine readmes

Change-Id: I3779282126cdd05b047194d356932b9995484115

Author: Jon Wayne Parrott

bigquery/README.md

@@ -128,7 +128,8 @@ To run this sample:
     For more information, see the README.md under /bigquery.
     
     Example invocation:
-        $ python async_query.py           'SELECT corpus FROM `publicdata.samples.shakespeare` GROUP BY corpus'
+        $ python async_query.py \
+              'SELECT corpus FROM `publicdata.samples.shakespeare` GROUP BY corpus'
     
     positional arguments:
       query       BigQuery SQL Query.

bigquery/cloud-client/README.rst

@@ -0,0 +1,20 @@
+# This file is used to generate README.rst
+
+product:
+  name: Google Cloud Natural Language API
+  short_name: Cloud Natural Language API
+  url: https://cloud.google.com/natural-language/docs/
+  description: > 
+    The `Google Cloud Natural Language API`_ provides natural language
+    understanding technologies to developers, including sentiment analysis,
+    entity recognition, and syntax analysis. This API is part of the larger
+    Cloud Machine Learning API.
+
+setup:
+- auth
+- install_deps
+
+samples:
+- name: Analyze syntax
+  file: analyze.py
+  show_help: true

language/api/README.md

@@ -0,0 +1,21 @@
+# This file is used to generate README.rst
+
+product:
+  name: Google Cloud Natural Language API
+  short_name: Cloud Natural Language API
+  url: https://cloud.google.com/natural-language/docs/
+  description: > 
+    The `Google Cloud Natural Language API`_ provides natural language
+    understanding technologies to developers, including sentiment analysis,
+    entity recognition, and syntax analysis. This API is part of the larger
+    Cloud Machine Learning API.
+
+setup:
+- auth
+- install_deps
+
+samples:
+- name: Quickstart
+  file: quickstart.py
+
+cloud_client_library: true

language/api/README.rst.in

@@ -0,0 +1,14 @@
+Authentication
+++++++++++++++
+
+Authentication for this service is done via an `API Key`_. To obtain an API
+Key:
+
+1. Open the `Cloud Platform Console`_
+2. Make sure that billing is enabled for your project.
+3. From the **Credentials** page, create a new **API Key** or use an existing
+   one for your project.
+
+.. _API Key:
+    https://developers.google.com/api-client-library/python/guide/aaa_apikeys
+.. _Cloud Console: https://console.cloud.google.com/project?_

language/cloud-client/README.rst.in

@@ -0,0 +1,26 @@
+Install PortAudio
++++++++++++++++++
+
+Install `PortAudio`_. This is required by the `PyAudio`_ library to stream
+audio from your computer's microphone. PyAudio depends on PortAudio for cross-platform compatibility, and is installed differently depending on the
+platform.
+
+For Mac OS X, you can use `Homebrew`_::
+
+    brew install portaudio
+
+For Debian / Ubuntu Linux::
+
+    apt-get install portaudio19-dev python-all-dev
+
+Windows may work without having to install PortAudio explicitly (it will get
+installed with PyAudio).
+
+For more details, see the `PyAudio installation`_ page.
+
+
+.. _PyAudio: https://people.csail.mit.edu/hubert/pyaudio/
+.. _PortAudio: http://www.portaudio.com/
+.. _PyAudio installation:
+  https://people.csail.mit.edu/hubert/pyaudio/#downloads
+.. _Homebrew: http://brew.sh