More docs changes

AUTHENTICATION.md

@@ -1,18 +1,38 @@
 # Authentication
 
-In general, the google-cloud-ruby library uses [Service Account](https://cloud.google.com/iam/docs/creating-managing-service-accounts) credentials to connect to Google Cloud services. When running on Compute Engine the credentials will be discovered automatically. When running on other environments, the Service Account credentials can be specified by providing the path to the [JSON keyfile](https://cloud.google.com/iam/docs/managing-service-account-keys) for the account (or the JSON itself) in environment variables. Additionally, Cloud SDK credentials can also be discovered automatically, but this is only recommended during development.
-
-General instructions, environment variables, and configuration options are covered in the general [Authentication guide](http://googlecloudplatform.github.io/google-cloud-ruby/#/docs/google-cloud/guides/authentication) for the `google-cloud` umbrella package. Specific instructions and environment variables for each individual service are linked from the README documents listed below for each service.
+In general, the google-cloud-ruby library uses [Service
+Account](https://cloud.google.com/iam/docs/creating-managing-service-accounts)
+credentials to connect to Google Cloud services. When running on Compute Engine
+the credentials will be discovered automatically. When running on other
+environments, the Service Account credentials can be specified by providing the
+path to the [JSON
+keyfile](https://cloud.google.com/iam/docs/managing-service-account-keys) for
+the account (or the JSON itself) in environment variables. Additionally, Cloud
+SDK credentials can also be discovered automatically, but this is only
+recommended during development.
+
+General instructions, environment variables, and configuration options are
+covered in the general [Authentication
+guide](https://googlecloudplatform.github.io/google-cloud-ruby/docs/authentication)
+for the `google-cloud` umbrella package. Specific instructions and environment
+variables for each individual service are linked from the README documents
+listed below for each service.
 
 ## Creating a Service Account
 
-Google Cloud requires a **Project ID** and **Service Account Credentials** to connect to the APIs. For detailed instructions on how to create a service account, see the [Authentication guide](docs/google-cloud/v0.12.2/guides/authentication#onyourownserver).
+Google Cloud requires a **Project ID** and **Service Account Credentials** to
+connect to the APIs. For detailed instructions on how to create a service
+account, see the [Authentication
+guide](docs/google-cloud/v0.12.2/guides/authentication#onyourownserver).
 
-You will use the **Project ID** and **JSON key file** to connect to most services with google-cloud-ruby.
+You will use the **Project ID** and **JSON key file** to connect to most
+services with google-cloud-ruby.
 
 ## Project and Credential Lookup
 
-The google-cloud-ruby library aims to make authentication as simple as possible, and provides several mechanisms to configure your system without providing **Project ID** and **Service Account Credentials** directly in code.
+The google-cloud-ruby library aims to make authentication as simple as possible,
+and provides several mechanisms to configure your system without providing
+**Project ID** and **Service Account Credentials** directly in code.
 
 **Project ID** is discovered in the following order:
 
@@ -30,11 +50,21 @@ The google-cloud-ruby library aims to make authentication as simple as possible,
 
 ### Google Cloud Platform environments
 
-While running on Google Cloud Platform environments such as Google Compute Engine, Google App Engine and Google Kubernetes Engine, no extra work is needed. The **Project ID** and **Credentials** and are discovered automatically. Code should be written as if already authenticated.
+While running on Google Cloud Platform environments such as Google Compute
+Engine, Google App Engine and Google Kubernetes Engine, no extra work is needed.
+The **Project ID** and **Credentials** and are discovered automatically. Code
+should be written as if already authenticated.
 
 ### Environment Variables
 
-The **Project ID** and **Credentials JSON** can be placed in environment variables instead of declaring them directly in code. Each service has its own environment variable, allowing for different service accounts to be used for different services. (See the READMEs for the individual service gems for details.) The path to the **Credentials JSON** file can be stored in the environment variable, or the **Credentials JSON** itself can be stored for environments such as Docker containers where writing files is difficult or not encouraged.
+The **Project ID** and **Credentials JSON** can be placed in environment
+variables instead of declaring them directly in code. Each service has its own
+environment variable, allowing for different service accounts to be used for
+different services. (See the READMEs for the individual service gems for
+details.) The path to the **Credentials JSON** file can be stored in the
+environment variable, or the **Credentials JSON** itself can be stored for
+environments such as Docker containers where writing files is difficult or not
+encouraged.
 
 Here are the environment variables that Datastore checks for project ID:
 
@@ -50,16 +80,23 @@ Here are the environment variables that Datastore checks for credentials:
 
 ### Cloud SDK
 
-This option allows for an easy way to authenticate during development. If credentials are not provided in code or in environment variables, then Cloud SDK credentials are discovered.
+This option allows for an easy way to authenticate during development. If
+credentials are not provided in code or in environment variables, then Cloud SDK
+credentials are discovered.
 
 To configure your system for this, simply:
 
 1. [Download and install the Cloud SDK](https://cloud.google.com/sdk)
 2. Authenticate using OAuth 2.0 `$ gcloud auth login`
 3. Write code as if already authenticated.
 
-**NOTE:** This is _not_ recommended for running in production. The Cloud SDK should only be used during development.
+**NOTE:** This is _not_ recommended for running in production. The Cloud SDK
+*should only be used during development.
 
 ## Troubleshooting
 
-If you're having trouble authenticating open a [Github Issue](https://github.com/GoogleCloudPlatform/google-cloud-ruby/issues/new?title=Authentication+question) to get help.  Also consider searching or asking [questions](http://stackoverflow.com/questions/tagged/google-cloud-platform+ruby) on [StackOverflow](http://stackoverflow.com).
+If you're having trouble authenticating open a [Github
+Issue](https://github.com/GoogleCloudPlatform/google-cloud-ruby/issues/new?title=Authentication+question)
+to get help.  Also consider searching or asking
+[questions](http://stackoverflow.com/questions/tagged/google-cloud-platform+ruby)
+on [StackOverflow](http://stackoverflow.com).