docs: update generated docs (#1053)

Updates for both discovery docs and epydoc API Documentation

Fixes: #1049
diff --git a/docs/dyn/compute_v1.sslCertificates.html b/docs/dyn/compute_v1.sslCertificates.html
index dbcf0c7..7d65574 100644
--- a/docs/dyn/compute_v1.sslCertificates.html
+++ b/docs/dyn/compute_v1.sslCertificates.html
@@ -75,12 +75,15 @@
 <h1><a href="compute_v1.html">Compute Engine API</a> . <a href="compute_v1.sslCertificates.html">sslCertificates</a></h1>
 <h2>Instance Methods</h2>
 <p class="toc_element">
-  <code><a href="#aggregatedList">aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None)</a></code></p>
+  <code><a href="#aggregatedList">aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None)</a></code></p>
 <p class="firstline">Retrieves the list of all SslCertificate resources, regional and global, available to the specified project.</p>
 <p class="toc_element">
   <code><a href="#aggregatedList_next">aggregatedList_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
 <p class="toc_element">
+  <code><a href="#close">close()</a></code></p>
+<p class="firstline">Close httplib2 connections.</p>
+<p class="toc_element">
   <code><a href="#delete">delete(project, sslCertificate, requestId=None)</a></code></p>
 <p class="firstline">Deletes the specified SslCertificate resource.</p>
 <p class="toc_element">
@@ -90,14 +93,14 @@
   <code><a href="#insert">insert(project, body=None, requestId=None)</a></code></p>
 <p class="firstline">Creates a SslCertificate resource in the specified project using the data included in the request.</p>
 <p class="toc_element">
-  <code><a href="#list">list(project, filter=None, maxResults=None, orderBy=None, pageToken=None)</a></code></p>
+  <code><a href="#list">list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None)</a></code></p>
 <p class="firstline">Retrieves the list of SslCertificate resources available to the specified project.</p>
 <p class="toc_element">
   <code><a href="#list_next">list_next(previous_request, previous_response)</a></code></p>
 <p class="firstline">Retrieves the next page of results.</p>
 <h3>Method Details</h3>
 <div class="method">
-    <code class="details" id="aggregatedList">aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None)</code>
+    <code class="details" id="aggregatedList">aggregatedList(project, filter=None, includeAllScopes=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None)</code>
   <pre>Retrieves the list of all SslCertificate resources, regional and global, available to the specified project.
 
 Args:
@@ -117,6 +120,7 @@
 
 Currently, only sorting by `name` or `creationTimestamp desc` is supported.
   pageToken: string, Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.
+  returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.
 
 Returns:
   An object of the form:
@@ -141,7 +145,7 @@
               # The regionSslCertificates are used by internal HTTPS load balancers.
               #
               # Optionally, certificate file contents that you upload can contain a set of up to five PEM-encoded certificates. The API call creates an object (sslCertificate) that holds this data. You can use SSL keys and certificates to secure connections to a load balancer. For more information, read  Creating and using SSL certificates, SSL certificates quotas and limits, and  Troubleshooting SSL certificates. (== resource_for {$api_version}.sslCertificates ==) (== resource_for {$api_version}.regionSslCertificates ==)
-            &quot;certificate&quot;: &quot;A String&quot;, # A local certificate file. The certificate must be in PEM format. The certificate chain must be no greater than 5 certs long. The chain must include at least one intermediate cert.
+            &quot;certificate&quot;: &quot;A String&quot;, # A value read into memory from a certificate file. The certificate file must be in PEM format. The certificate chain must be no greater than 5 certs long. The chain must include at least one intermediate cert.
             &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Output Only] Creation timestamp in RFC3339 text format.
             &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you create the resource.
             &quot;expireTime&quot;: &quot;A String&quot;, # [Output Only] Expire time of the certificate. RFC3339
@@ -157,7 +161,7 @@
               &quot;status&quot;: &quot;A String&quot;, # [Output only] Status of the managed certificate resource.
             },
             &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
-            &quot;privateKey&quot;: &quot;A String&quot;, # A write-only private key in PEM format. Only insert requests will include this field.
+            &quot;privateKey&quot;: &quot;A String&quot;, # A value read into memory from a write-only private key file. The private key file must be in PEM format. For security, only insert requests include this field.
             &quot;region&quot;: &quot;A String&quot;, # [Output Only] URL of the region where the regional SSL Certificate resides. This field is not applicable to global SSL Certificate.
             &quot;selfLink&quot;: &quot;A String&quot;, # [Output only] Server-defined URL for the resource.
             &quot;selfManaged&quot;: { # Configuration and status of a self-managed SSL certificate. # Configuration and status of a self-managed SSL certificate.
@@ -186,6 +190,9 @@
     &quot;kind&quot;: &quot;compute#sslCertificateAggregatedList&quot;, # [Output Only] Type of resource. Always compute#sslCertificateAggregatedList for lists of SSL Certificates.
     &quot;nextPageToken&quot;: &quot;A String&quot;, # [Output Only] This token allows you to get the next page of results for list requests. If the number of results is larger than maxResults, use the nextPageToken as a value for the query parameter pageToken in the next list request. Subsequent list requests will have their own nextPageToken to continue paging through the results.
     &quot;selfLink&quot;: &quot;A String&quot;, # [Output Only] Server-defined URL for this resource.
+    &quot;unreachables&quot;: [ # [Output Only] Unreachable resources.
+      &quot;A String&quot;,
+    ],
     &quot;warning&quot;: { # [Output Only] Informational warning message.
       &quot;code&quot;: &quot;A String&quot;, # [Output Only] A warning code, if applicable. For example, Compute Engine returns NO_RESULTS_ON_PAGE if there are no results in the response.
       &quot;data&quot;: [ # [Output Only] Metadata about this warning in key: value format. For example:
@@ -215,6 +222,11 @@
 </div>
 
 <div class="method">
+    <code class="details" id="close">close()</code>
+  <pre>Close httplib2 connections.</pre>
+</div>
+
+<div class="method">
     <code class="details" id="delete">delete(project, sslCertificate, requestId=None)</code>
   <pre>Deletes the specified SslCertificate resource.
 
@@ -316,7 +328,7 @@
       # The regionSslCertificates are used by internal HTTPS load balancers.
       #
       # Optionally, certificate file contents that you upload can contain a set of up to five PEM-encoded certificates. The API call creates an object (sslCertificate) that holds this data. You can use SSL keys and certificates to secure connections to a load balancer. For more information, read  Creating and using SSL certificates, SSL certificates quotas and limits, and  Troubleshooting SSL certificates. (== resource_for {$api_version}.sslCertificates ==) (== resource_for {$api_version}.regionSslCertificates ==)
-    &quot;certificate&quot;: &quot;A String&quot;, # A local certificate file. The certificate must be in PEM format. The certificate chain must be no greater than 5 certs long. The chain must include at least one intermediate cert.
+    &quot;certificate&quot;: &quot;A String&quot;, # A value read into memory from a certificate file. The certificate file must be in PEM format. The certificate chain must be no greater than 5 certs long. The chain must include at least one intermediate cert.
     &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Output Only] Creation timestamp in RFC3339 text format.
     &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you create the resource.
     &quot;expireTime&quot;: &quot;A String&quot;, # [Output Only] Expire time of the certificate. RFC3339
@@ -332,7 +344,7 @@
       &quot;status&quot;: &quot;A String&quot;, # [Output only] Status of the managed certificate resource.
     },
     &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
-    &quot;privateKey&quot;: &quot;A String&quot;, # A write-only private key in PEM format. Only insert requests will include this field.
+    &quot;privateKey&quot;: &quot;A String&quot;, # A value read into memory from a write-only private key file. The private key file must be in PEM format. For security, only insert requests include this field.
     &quot;region&quot;: &quot;A String&quot;, # [Output Only] URL of the region where the regional SSL Certificate resides. This field is not applicable to global SSL Certificate.
     &quot;selfLink&quot;: &quot;A String&quot;, # [Output only] Server-defined URL for the resource.
     &quot;selfManaged&quot;: { # Configuration and status of a self-managed SSL certificate. # Configuration and status of a self-managed SSL certificate.
@@ -370,7 +382,7 @@
     # The regionSslCertificates are used by internal HTTPS load balancers.
     # 
     # Optionally, certificate file contents that you upload can contain a set of up to five PEM-encoded certificates. The API call creates an object (sslCertificate) that holds this data. You can use SSL keys and certificates to secure connections to a load balancer. For more information, read  Creating and using SSL certificates, SSL certificates quotas and limits, and  Troubleshooting SSL certificates. (== resource_for {$api_version}.sslCertificates ==) (== resource_for {$api_version}.regionSslCertificates ==)
-  &quot;certificate&quot;: &quot;A String&quot;, # A local certificate file. The certificate must be in PEM format. The certificate chain must be no greater than 5 certs long. The chain must include at least one intermediate cert.
+  &quot;certificate&quot;: &quot;A String&quot;, # A value read into memory from a certificate file. The certificate file must be in PEM format. The certificate chain must be no greater than 5 certs long. The chain must include at least one intermediate cert.
   &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Output Only] Creation timestamp in RFC3339 text format.
   &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you create the resource.
   &quot;expireTime&quot;: &quot;A String&quot;, # [Output Only] Expire time of the certificate. RFC3339
@@ -386,7 +398,7 @@
     &quot;status&quot;: &quot;A String&quot;, # [Output only] Status of the managed certificate resource.
   },
   &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
-  &quot;privateKey&quot;: &quot;A String&quot;, # A write-only private key in PEM format. Only insert requests will include this field.
+  &quot;privateKey&quot;: &quot;A String&quot;, # A value read into memory from a write-only private key file. The private key file must be in PEM format. For security, only insert requests include this field.
   &quot;region&quot;: &quot;A String&quot;, # [Output Only] URL of the region where the regional SSL Certificate resides. This field is not applicable to global SSL Certificate.
   &quot;selfLink&quot;: &quot;A String&quot;, # [Output only] Server-defined URL for the resource.
   &quot;selfManaged&quot;: { # Configuration and status of a self-managed SSL certificate. # Configuration and status of a self-managed SSL certificate.
@@ -469,7 +481,7 @@
 </div>
 
 <div class="method">
-    <code class="details" id="list">list(project, filter=None, maxResults=None, orderBy=None, pageToken=None)</code>
+    <code class="details" id="list">list(project, filter=None, maxResults=None, orderBy=None, pageToken=None, returnPartialSuccess=None)</code>
   <pre>Retrieves the list of SslCertificate resources available to the specified project.
 
 Args:
@@ -488,6 +500,7 @@
 
 Currently, only sorting by `name` or `creationTimestamp desc` is supported.
   pageToken: string, Specifies a page token to use. Set `pageToken` to the `nextPageToken` returned by a previous list request to get the next page of results.
+  returnPartialSuccess: boolean, Opt-in for partial success behavior which provides partial results in case of failure. The default value is false and the logic is the same as today.
 
 Returns:
   An object of the form:
@@ -510,7 +523,7 @@
           # The regionSslCertificates are used by internal HTTPS load balancers.
           #
           # Optionally, certificate file contents that you upload can contain a set of up to five PEM-encoded certificates. The API call creates an object (sslCertificate) that holds this data. You can use SSL keys and certificates to secure connections to a load balancer. For more information, read  Creating and using SSL certificates, SSL certificates quotas and limits, and  Troubleshooting SSL certificates. (== resource_for {$api_version}.sslCertificates ==) (== resource_for {$api_version}.regionSslCertificates ==)
-        &quot;certificate&quot;: &quot;A String&quot;, # A local certificate file. The certificate must be in PEM format. The certificate chain must be no greater than 5 certs long. The chain must include at least one intermediate cert.
+        &quot;certificate&quot;: &quot;A String&quot;, # A value read into memory from a certificate file. The certificate file must be in PEM format. The certificate chain must be no greater than 5 certs long. The chain must include at least one intermediate cert.
         &quot;creationTimestamp&quot;: &quot;A String&quot;, # [Output Only] Creation timestamp in RFC3339 text format.
         &quot;description&quot;: &quot;A String&quot;, # An optional description of this resource. Provide this property when you create the resource.
         &quot;expireTime&quot;: &quot;A String&quot;, # [Output Only] Expire time of the certificate. RFC3339
@@ -526,7 +539,7 @@
           &quot;status&quot;: &quot;A String&quot;, # [Output only] Status of the managed certificate resource.
         },
         &quot;name&quot;: &quot;A String&quot;, # Name of the resource. Provided by the client when the resource is created. The name must be 1-63 characters long, and comply with RFC1035. Specifically, the name must be 1-63 characters long and match the regular expression `[a-z]([-a-z0-9]*[a-z0-9])?` which means the first character must be a lowercase letter, and all following characters must be a dash, lowercase letter, or digit, except the last character, which cannot be a dash.
-        &quot;privateKey&quot;: &quot;A String&quot;, # A write-only private key in PEM format. Only insert requests will include this field.
+        &quot;privateKey&quot;: &quot;A String&quot;, # A value read into memory from a write-only private key file. The private key file must be in PEM format. For security, only insert requests include this field.
         &quot;region&quot;: &quot;A String&quot;, # [Output Only] URL of the region where the regional SSL Certificate resides. This field is not applicable to global SSL Certificate.
         &quot;selfLink&quot;: &quot;A String&quot;, # [Output only] Server-defined URL for the resource.
         &quot;selfManaged&quot;: { # Configuration and status of a self-managed SSL certificate. # Configuration and status of a self-managed SSL certificate.