Repository: googleapis/google-cloud-python

Issue:
Redis Client Reference Docs 404
Link from [Redis README](https://github.com/GoogleCloudPlatform/google-cloud-python/blob/master/redis/README.rst) to API client reference documentation (https://googlecloudplatform.github.io/google-cloud-python/stable/redis/usage.html) does not resolve (404).
Redis Client Reference Docs 404
Link from [Redis README](https://github.com/GoogleCloudPlatform/google-cloud-python/blob/master/redis/README.rst) to API client reference documentation (https://googlecloudplatform.github.io/google-cloud-python/stable/redis/usage.html) does not resolve (404).


Discussion:
Looks to me as though the CI docs build / publish isn't working (we have other docs bugs open which are likely symptoms of the same problem).
https://github.com/rtfd/readthedocs.org/issues/4127
Redis docs *do* need to be symlinked into the top-level /docs directory.
It seems maybe our template for the README needs to be updated to use ReadTheDocs links. That said,
http://google-cloud-python.readthedocs.io/en/latest/ should have it but redis isn't there either.
Just making a note here that @danoscarmike merged https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5358 which should have added Redis. 
Next steps here? We're blocked on inserting links from cloud.google.com.  

@crwilcox #5358 links out to PyPI (I just followed suit, but I agree it would be more meaningful to link to reference docs or both).
Looks to me as though the CI docs build / publish isn't working (we have other docs bugs open which are likely symptoms of the same problem).
https://github.com/rtfd/readthedocs.org/issues/4127
Redis docs *do* need to be symlinked into the top-level /docs directory.
It seems maybe our template for the README needs to be updated to use ReadTheDocs links. That said,
http://google-cloud-python.readthedocs.io/en/latest/ should have it but redis isn't there either.
Just making a note here that @danoscarmike merged https://github.com/GoogleCloudPlatform/google-cloud-python/pull/5358 which should have added Redis. 
Next steps here? We're blocked on inserting links from cloud.google.com.  

@crwilcox #5358 links out to PyPI (I just followed suit, but I agree it would be more meaningful to link to reference docs or both).

Resolving patch:
diff --git a/redis/google/cloud/redis_v1beta1/gapic/cloud_redis_client.py b/redis/google/cloud/redis_v1beta1/gapic/cloud_redis_client.py
--- a/redis/google/cloud/redis_v1beta1/gapic/cloud_redis_client.py
+++ b/redis/google/cloud/redis_v1beta1/gapic/cloud_redis_client.py
@@ -51,6 +51,7 @@ class CloudRedisClient(object):
     * Each project has a collection of available locations, named: ``/locations/*``
     * Each location has a collection of Redis instances, named: ``/instances/*``
     * As such, Redis instances are resources of the form:
+      
       ``/projects/{project_id}/locations/{location_id}/instances/{instance_id}``
 
     Note that location_id must be refering to a GCP ``region``; for example:
@@ -219,9 +220,7 @@ def list_instances(self,
 
         Args:
             parent (str): Required. The resource name of the instance location using the form:
-                ::
-
-                    `projects/{project_id}/locations/{location_id}`
+                `projects/{project_id}/locations/{location_id}`
                 where ``location_id`` refers to a GCP region
             page_size (int): The maximum number of resources contained in the
                 underlying API response. If page streaming is performed per-
@@ -290,9 +289,7 @@ def get_instance(self,
 
         Args:
             name (str): Required. Redis instance resource name using the form:
-                ::
-
-                    `projects/{project_id}/locations/{location_id}/instances/{instance_id}`
+                `projects/{project_id}/locations/{location_id}/instances/{instance_id}`
                 where ``location_id`` refers to a GCP region
             retry (Optional[google.api_core.retry.Retry]):  A retry object used
                 to retry requests. If ``None`` is specified, requests will not
@@ -366,11 +363,8 @@ def create_instance(self,
 
         Args:
             parent (str): Required. The resource name of the instance location using the form:
-                ::
-
-                    `projects/{project_id}/locations/{location_id}`
-                where ``location_id`` refers to a GCP region
-            instance_id (str): Required. The logical name of the Redis instance in the customer project
+                `projects/{project_id}/locations/{location_id}` where ``location_id`` refers to a GCP region
+                instance_id (str): Required. The logical name of the Redis instance in the customer project
                 with the following restrictions:
 
                 * Must contain only lowercase letters, numbers, and hyphens.
@@ -532,11 +526,9 @@ def delete_instance(self,
 
         Args:
             name (str): Required. Redis instance resource name using the form:
-                ::
-
-                    `projects/{project_id}/locations/{location_id}/instances/{instance_id}`
+                `projects/{project_id}/locations/{location_id}/instances/{instance_id}`
                 where ``location_id`` refers to a GCP region
-            retry (Optional[google.api_core.retry.Retry]):  A retry object used
+            retry (Optional[google.api_core.retry.Retry]): A retry object used
                 to retry requests. If ``None`` is specified, requests will not
                 be retried.
             timeout (Optional[float]): The amount of time, in seconds, to wait


Test patch: