Editorial comments.

Change-Id: Ifd8d997af4946a77a84b122dd2166469d2228bdd

Author: Nick Cook

google-assistant-library/README.rst

@@ -6,22 +6,21 @@ This package contains high level Python_ bindings for the `Google Assistant Libr
 It is part of the `Google Assistant SDK`_.
 
 It includes the following features:
-- "Ok Google" or "Hey Google" hotword detection.
-- Audio recording.
-- Assistant response playback.
-- Timer and alarm features.
-- Volume ducking and control.
-- Conversation state management.
+- "Ok Google" or "Hey Google" hotword detection
+- Audio recording
+- Assistant response playback
+- Timer and alarm features
+- Volume ducking and control
+- Conversation state management
 
-See `Getting Started Guide for Raspberry Pi`_ for a step by step guide on how to get started with the library on Raspberry Pi 3.
+See `Getting Started with the Raspberry Pi and Python`_ for a step by step guide on how to get started with the library on Raspberry Pi 3.
 
 Supported configuration
 -----------------------
 
 - Python ``>= 3.4``
 - Architecture: ``linux-arm7l``
 
-
 Installing
 ----------
 
@@ -33,12 +32,12 @@ Installing
 Authorization
 -------------
 
-- `Follow the steps`_ to configure a Google API Console Project and a Google Account to use with the Google Assistant SDK.
+- `Follow the steps`_ to configure a Google API Console Project and a Google account to use with the Google Assistant SDK.
 
-- Download the ``client_secret_XXXXX.json`` file from the `Google API Console Project credentials section`_ and generatte credentials using ``google-oauth-tool``.::
+- Download the ``client_secret_XXXXX.json`` file from the `Google API Console Project credentials section`_ and generate credentials using ``google-oauth-tool``.::
 
     pip install --upgrade google-auth-oauthlib[tool]
-    google-oauthlib-tool --client-secrets path/to/client_secret_XXXXX.json --scope https://www.googleapis.com/auth/assistant-sdk-prototype --save
+    google-oauthlib-tool --client-secrets path/to/client_secret_XXXXX.json --scope https://www.googleapis.com/auth/assistant-sdk-prototype --save --headless
 
 Usage
 -----
@@ -47,14 +46,14 @@ Usage
 
     google-assistant-demo
 
-- Say "Ok Google", followed by a voice query: the demo should
-  playback the assistant answer and log events to the screen.
+- Say "Ok Google", followed by a voice query. The demo should
+  play back the Assistant's response and log events to the screen.
 
 Reference
 ---------
 
-- `Reference sample`_ for the Google Assistant Library for Python.
-- `Google Assistant Library`_ reference.
+- `Reference sample`_ for the Google Assistant Library for Python
+- `Google Assistant Library`_ reference
 
 License
 -------

google-assistant-sdk/googlesamples/assistant/grpc/README.rst

@@ -5,11 +5,11 @@ This repository contains a reference sample for the ``google-assistant-grpc`` Py
 
 It implements the following features:
 
-- Triggering a conversation using a key press.
-- Audio recording of user queries (single or multiple consecutive queries).
-- Playback of the Assistant response.
-- Conversation state management.
-- Volume control.
+- Triggering a conversation using a key press
+- Audio recording of user queries (single or multiple consecutive queries)
+- Playback of the Assistant response
+- Conversation state management
+- Volume control
 
 .. _package: https://pypi.python.org/pypi/google-assistant-grpc
 
@@ -62,7 +62,7 @@ Run the sample
     # Record a 5 sec sample and play it back
     python -m audio_helpers
 
-- Run the push to talk sample: the sample records a voice query after a key press and plays back the Google Assistant's answer::
+- Run the push to talk sample. The sample records a voice query after a key press and plays back the Google Assistant's answer::
 
     python -m pushtotalk
 

google-assistant-sdk/googlesamples/assistant/library/README.rst

@@ -4,16 +4,16 @@ Python samples for the Google Assistant library
 This repository contains a reference sample for the ``google-assistant-library`` Python package_.
 
 It demonstrates:
-- Initialization of the Assistant.
+- Initialization of the Assistant
 - Basic event handling including hotword detection.
 
 .. _package: https://github.com/googlesamples/assistant-sdk-python/tree/master/google-assistant-library.
 
 Prerequisites
 -------------
 
-- `Python <https://www.python.org/>`_ >= 3.4.
-- Raspberry Pi 3 running Rasbian (or any other ``linux-arm7l`` SBC).
+- `Python <https://www.python.org/>`_ >= 3.4
+- Raspberry Pi 3 running Rasbian (or any other ``linux-arm7l`` SBC)
 - A `Google API Console Project <https://console.developers.google.com>`_
 - A `Google account <https://myaccount.google.com/>`_
 
@@ -58,14 +58,14 @@ Run the sample
 .. _pip: https://pip.pypa.io/
 .. _GitHub releases page: https://github.com/googlesamples/assistant-sdk-python/releases
 
-- Run the hotword sample: the sample waits for the "Ok Google" hotword", then records a voice query and plays back the Google Assistant's answer::
+- Run the hotword sample. The sample waits for the "Ok Google" hotword, then records a voice query and plays back the Google Assistant's answer::
 
     python -m hotword
 
 Troubleshooting
 ---------------
 
-- If audio is not working: verify ALSA setup::
+- If audio is not working, verify the ALSA setup::
 
     # Play a test sound
     speaker-test -t wav