docs: update generated docs (#1053)

Updates for both discovery docs and epydoc API Documentation

Fixes: #1049
diff --git a/docs/dyn/dialogflow_v2beta1.projects.agent.knowledgeBases.html b/docs/dyn/dialogflow_v2beta1.projects.agent.knowledgeBases.html
index 5f9e1de..bebd26e 100644
--- a/docs/dyn/dialogflow_v2beta1.projects.agent.knowledgeBases.html
+++ b/docs/dyn/dialogflow_v2beta1.projects.agent.knowledgeBases.html
@@ -80,55 +80,45 @@
 <p class="firstline">Returns the documents Resource.</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="#create">create(parent, body=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Creates a knowledge base.</p>
+<p class="firstline">Creates a knowledge base. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.</p>
 <p class="toc_element">
   <code><a href="#delete">delete(name, force=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Deletes the specified knowledge base.</p>
+<p class="firstline">Deletes the specified knowledge base. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.</p>
 <p class="toc_element">
   <code><a href="#get">get(name, x__xgafv=None)</a></code></p>
-<p class="firstline">Retrieves the specified knowledge base.</p>
+<p class="firstline">Retrieves the specified knowledge base. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.</p>
 <p class="toc_element">
   <code><a href="#list">list(parent, pageSize=None, pageToken=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Returns the list of all knowledge bases of the specified agent.</p>
+<p class="firstline">Returns the list of all knowledge bases of the specified agent. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.</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>
 <p class="toc_element">
   <code><a href="#patch">patch(name, body=None, updateMask=None, x__xgafv=None)</a></code></p>
-<p class="firstline">Updates the specified knowledge base.</p>
+<p class="firstline">Updates the specified knowledge base. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.</p>
 <h3>Method Details</h3>
 <div class="method">
-    <code class="details" id="create">create(parent, body=None, x__xgafv=None)</code>
-  <pre>Creates a knowledge base.
+    <code class="details" id="close">close()</code>
+  <pre>Close httplib2 connections.</pre>
+</div>
 
-Note: The `projects.agent.knowledgeBases` resource is deprecated;
-only use `projects.knowledgeBases`.
+<div class="method">
+    <code class="details" id="create">create(parent, body=None, x__xgafv=None)</code>
+  <pre>Creates a knowledge base. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.
 
 Args:
-  parent: string, Required. The project to create a knowledge base for.
-Format: `projects/&lt;Project ID&gt;`. (required)
+  parent: string, Required. The project to create a knowledge base for. Format: `projects/`. (required)
   body: object, The request body.
     The object takes the form of:
 
-{ # A knowledge base represents a collection of knowledge documents that you
-      # provide to Dialogflow. Your knowledge documents contain information that may
-      # be useful during conversations with end-users. Some Dialogflow features use
-      # knowledge bases when looking for a response to an end-user input.
-      # 
-      # For more information, see the [knowledge base
-      # guide](https://cloud.google.com/dialogflow/docs/how/knowledge-bases).
-      # 
-      # Note: The `projects.agent.knowledgeBases` resource is deprecated;
-      # only use `projects.knowledgeBases`.
-    &quot;displayName&quot;: &quot;A String&quot;, # Required. The display name of the knowledge base. The name must be 1024
-        # bytes or less; otherwise, the creation request fails.
-    &quot;name&quot;: &quot;A String&quot;, # The knowledge base resource name.
-        # The name must be empty when creating a knowledge base.
-        # Format: `projects/&lt;Project ID&gt;/knowledgeBases/&lt;Knowledge Base ID&gt;`.
-    &quot;languageCode&quot;: &quot;A String&quot;, # Language which represents the KnowledgeBase. When the KnowledgeBase is
-        # created/updated, this is populated for all non en-us languages. If not
-        # populated, the default language en-us applies.
+{ # A knowledge base represents a collection of knowledge documents that you provide to Dialogflow. Your knowledge documents contain information that may be useful during conversations with end-users. Some Dialogflow features use knowledge bases when looking for a response to an end-user input. For more information, see the [knowledge base guide](https://cloud.google.com/dialogflow/docs/how/knowledge-bases). Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.
+    &quot;languageCode&quot;: &quot;A String&quot;, # Language which represents the KnowledgeBase. When the KnowledgeBase is created/updated, this is populated for all non en-us languages. If not populated, the default language en-us applies.
+    &quot;name&quot;: &quot;A String&quot;, # The knowledge base resource name. The name must be empty when creating a knowledge base. Format: `projects//knowledgeBases/`.
+    &quot;displayName&quot;: &quot;A String&quot;, # Required. The display name of the knowledge base. The name must be 1024 bytes or less; otherwise, the creation request fails.
   }
 
   x__xgafv: string, V1 error format.
@@ -139,39 +129,20 @@
 Returns:
   An object of the form:
 
-    { # A knowledge base represents a collection of knowledge documents that you
-        # provide to Dialogflow. Your knowledge documents contain information that may
-        # be useful during conversations with end-users. Some Dialogflow features use
-        # knowledge bases when looking for a response to an end-user input.
-        #
-        # For more information, see the [knowledge base
-        # guide](https://cloud.google.com/dialogflow/docs/how/knowledge-bases).
-        #
-        # Note: The `projects.agent.knowledgeBases` resource is deprecated;
-        # only use `projects.knowledgeBases`.
-      &quot;displayName&quot;: &quot;A String&quot;, # Required. The display name of the knowledge base. The name must be 1024
-          # bytes or less; otherwise, the creation request fails.
-      &quot;name&quot;: &quot;A String&quot;, # The knowledge base resource name.
-          # The name must be empty when creating a knowledge base.
-          # Format: `projects/&lt;Project ID&gt;/knowledgeBases/&lt;Knowledge Base ID&gt;`.
-      &quot;languageCode&quot;: &quot;A String&quot;, # Language which represents the KnowledgeBase. When the KnowledgeBase is
-          # created/updated, this is populated for all non en-us languages. If not
-          # populated, the default language en-us applies.
+    { # A knowledge base represents a collection of knowledge documents that you provide to Dialogflow. Your knowledge documents contain information that may be useful during conversations with end-users. Some Dialogflow features use knowledge bases when looking for a response to an end-user input. For more information, see the [knowledge base guide](https://cloud.google.com/dialogflow/docs/how/knowledge-bases). Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.
+      &quot;languageCode&quot;: &quot;A String&quot;, # Language which represents the KnowledgeBase. When the KnowledgeBase is created/updated, this is populated for all non en-us languages. If not populated, the default language en-us applies.
+      &quot;name&quot;: &quot;A String&quot;, # The knowledge base resource name. The name must be empty when creating a knowledge base. Format: `projects//knowledgeBases/`.
+      &quot;displayName&quot;: &quot;A String&quot;, # Required. The display name of the knowledge base. The name must be 1024 bytes or less; otherwise, the creation request fails.
     }</pre>
 </div>
 
 <div class="method">
     <code class="details" id="delete">delete(name, force=None, x__xgafv=None)</code>
-  <pre>Deletes the specified knowledge base.
-
-Note: The `projects.agent.knowledgeBases` resource is deprecated;
-only use `projects.knowledgeBases`.
+  <pre>Deletes the specified knowledge base. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.
 
 Args:
-  name: string, Required. The name of the knowledge base to delete.
-Format: `projects/&lt;Project ID&gt;/knowledgeBases/&lt;Knowledge Base ID&gt;`. (required)
-  force: boolean, Optional. Force deletes the knowledge base. When set to true, any documents
-in the knowledge base are also deleted.
+  name: string, Required. The name of the knowledge base to delete. Format: `projects//knowledgeBases/`. (required)
+  force: boolean, Optional. Force deletes the knowledge base. When set to true, any documents in the knowledge base are also deleted.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -180,28 +151,16 @@
 Returns:
   An object of the form:
 
-    { # A generic empty message that you can re-use to avoid defining duplicated
-      # empty messages in your APIs. A typical example is to use it as the request
-      # or the response type of an API method. For instance:
-      #
-      #     service Foo {
-      #       rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty);
-      #     }
-      #
-      # The JSON representation for `Empty` is empty JSON object `{}`.
+    { # A generic empty message that you can re-use to avoid defining duplicated empty messages in your APIs. A typical example is to use it as the request or the response type of an API method. For instance: service Foo { rpc Bar(google.protobuf.Empty) returns (google.protobuf.Empty); } The JSON representation for `Empty` is empty JSON object `{}`.
   }</pre>
 </div>
 
 <div class="method">
     <code class="details" id="get">get(name, x__xgafv=None)</code>
-  <pre>Retrieves the specified knowledge base.
-
-Note: The `projects.agent.knowledgeBases` resource is deprecated;
-only use `projects.knowledgeBases`.
+  <pre>Retrieves the specified knowledge base. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.
 
 Args:
-  name: string, Required. The name of the knowledge base to retrieve.
-Format `projects/&lt;Project ID&gt;/knowledgeBases/&lt;Knowledge Base ID&gt;`. (required)
+  name: string, Required. The name of the knowledge base to retrieve. Format `projects//knowledgeBases/`. (required)
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -210,40 +169,21 @@
 Returns:
   An object of the form:
 
-    { # A knowledge base represents a collection of knowledge documents that you
-        # provide to Dialogflow. Your knowledge documents contain information that may
-        # be useful during conversations with end-users. Some Dialogflow features use
-        # knowledge bases when looking for a response to an end-user input.
-        #
-        # For more information, see the [knowledge base
-        # guide](https://cloud.google.com/dialogflow/docs/how/knowledge-bases).
-        #
-        # Note: The `projects.agent.knowledgeBases` resource is deprecated;
-        # only use `projects.knowledgeBases`.
-      &quot;displayName&quot;: &quot;A String&quot;, # Required. The display name of the knowledge base. The name must be 1024
-          # bytes or less; otherwise, the creation request fails.
-      &quot;name&quot;: &quot;A String&quot;, # The knowledge base resource name.
-          # The name must be empty when creating a knowledge base.
-          # Format: `projects/&lt;Project ID&gt;/knowledgeBases/&lt;Knowledge Base ID&gt;`.
-      &quot;languageCode&quot;: &quot;A String&quot;, # Language which represents the KnowledgeBase. When the KnowledgeBase is
-          # created/updated, this is populated for all non en-us languages. If not
-          # populated, the default language en-us applies.
+    { # A knowledge base represents a collection of knowledge documents that you provide to Dialogflow. Your knowledge documents contain information that may be useful during conversations with end-users. Some Dialogflow features use knowledge bases when looking for a response to an end-user input. For more information, see the [knowledge base guide](https://cloud.google.com/dialogflow/docs/how/knowledge-bases). Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.
+      &quot;languageCode&quot;: &quot;A String&quot;, # Language which represents the KnowledgeBase. When the KnowledgeBase is created/updated, this is populated for all non en-us languages. If not populated, the default language en-us applies.
+      &quot;name&quot;: &quot;A String&quot;, # The knowledge base resource name. The name must be empty when creating a knowledge base. Format: `projects//knowledgeBases/`.
+      &quot;displayName&quot;: &quot;A String&quot;, # Required. The display name of the knowledge base. The name must be 1024 bytes or less; otherwise, the creation request fails.
     }</pre>
 </div>
 
 <div class="method">
     <code class="details" id="list">list(parent, pageSize=None, pageToken=None, x__xgafv=None)</code>
-  <pre>Returns the list of all knowledge bases of the specified agent.
-
-Note: The `projects.agent.knowledgeBases` resource is deprecated;
-only use `projects.knowledgeBases`.
+  <pre>Returns the list of all knowledge bases of the specified agent. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.
 
 Args:
-  parent: string, Required. The project to list of knowledge bases for.
-Format: `projects/&lt;Project ID&gt;`. (required)
-  pageSize: integer, Optional. The maximum number of items to return in a single page. By
-default 10 and at most 100.
-  pageToken: string, Optional. The next_page_token value returned from a previous list request.
+  parent: string, Required. The project to list of knowledge bases for. Format: `projects/`. (required)
+  pageSize: integer, The maximum number of items to return in a single page. By default 10 and at most 100.
+  pageToken: string, The next_page_token value returned from a previous list request.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -253,29 +193,14 @@
   An object of the form:
 
     { # Response message for KnowledgeBases.ListKnowledgeBases.
+    &quot;nextPageToken&quot;: &quot;A String&quot;, # Token to retrieve the next page of results, or empty if there are no more results in the list.
     &quot;knowledgeBases&quot;: [ # The list of knowledge bases.
-      { # A knowledge base represents a collection of knowledge documents that you
-            # provide to Dialogflow. Your knowledge documents contain information that may
-            # be useful during conversations with end-users. Some Dialogflow features use
-            # knowledge bases when looking for a response to an end-user input.
-            #
-            # For more information, see the [knowledge base
-            # guide](https://cloud.google.com/dialogflow/docs/how/knowledge-bases).
-            #
-            # Note: The `projects.agent.knowledgeBases` resource is deprecated;
-            # only use `projects.knowledgeBases`.
-          &quot;displayName&quot;: &quot;A String&quot;, # Required. The display name of the knowledge base. The name must be 1024
-              # bytes or less; otherwise, the creation request fails.
-          &quot;name&quot;: &quot;A String&quot;, # The knowledge base resource name.
-              # The name must be empty when creating a knowledge base.
-              # Format: `projects/&lt;Project ID&gt;/knowledgeBases/&lt;Knowledge Base ID&gt;`.
-          &quot;languageCode&quot;: &quot;A String&quot;, # Language which represents the KnowledgeBase. When the KnowledgeBase is
-              # created/updated, this is populated for all non en-us languages. If not
-              # populated, the default language en-us applies.
+      { # A knowledge base represents a collection of knowledge documents that you provide to Dialogflow. Your knowledge documents contain information that may be useful during conversations with end-users. Some Dialogflow features use knowledge bases when looking for a response to an end-user input. For more information, see the [knowledge base guide](https://cloud.google.com/dialogflow/docs/how/knowledge-bases). Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.
+          &quot;languageCode&quot;: &quot;A String&quot;, # Language which represents the KnowledgeBase. When the KnowledgeBase is created/updated, this is populated for all non en-us languages. If not populated, the default language en-us applies.
+          &quot;name&quot;: &quot;A String&quot;, # The knowledge base resource name. The name must be empty when creating a knowledge base. Format: `projects//knowledgeBases/`.
+          &quot;displayName&quot;: &quot;A String&quot;, # Required. The display name of the knowledge base. The name must be 1024 bytes or less; otherwise, the creation request fails.
         },
     ],
-    &quot;nextPageToken&quot;: &quot;A String&quot;, # Token to retrieve the next page of results, or empty if there are no
-        # more results in the list.
   }</pre>
 </div>
 
@@ -295,41 +220,20 @@
 
 <div class="method">
     <code class="details" id="patch">patch(name, body=None, updateMask=None, x__xgafv=None)</code>
-  <pre>Updates the specified knowledge base.
-
-Note: The `projects.agent.knowledgeBases` resource is deprecated;
-only use `projects.knowledgeBases`.
+  <pre>Updates the specified knowledge base. Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.
 
 Args:
-  name: string, The knowledge base resource name.
-The name must be empty when creating a knowledge base.
-Format: `projects/&lt;Project ID&gt;/knowledgeBases/&lt;Knowledge Base ID&gt;`. (required)
+  name: string, The knowledge base resource name. The name must be empty when creating a knowledge base. Format: `projects//knowledgeBases/`. (required)
   body: object, The request body.
     The object takes the form of:
 
-{ # A knowledge base represents a collection of knowledge documents that you
-      # provide to Dialogflow. Your knowledge documents contain information that may
-      # be useful during conversations with end-users. Some Dialogflow features use
-      # knowledge bases when looking for a response to an end-user input.
-      # 
-      # For more information, see the [knowledge base
-      # guide](https://cloud.google.com/dialogflow/docs/how/knowledge-bases).
-      # 
-      # Note: The `projects.agent.knowledgeBases` resource is deprecated;
-      # only use `projects.knowledgeBases`.
-    &quot;displayName&quot;: &quot;A String&quot;, # Required. The display name of the knowledge base. The name must be 1024
-        # bytes or less; otherwise, the creation request fails.
-    &quot;name&quot;: &quot;A String&quot;, # The knowledge base resource name.
-        # The name must be empty when creating a knowledge base.
-        # Format: `projects/&lt;Project ID&gt;/knowledgeBases/&lt;Knowledge Base ID&gt;`.
-    &quot;languageCode&quot;: &quot;A String&quot;, # Language which represents the KnowledgeBase. When the KnowledgeBase is
-        # created/updated, this is populated for all non en-us languages. If not
-        # populated, the default language en-us applies.
+{ # A knowledge base represents a collection of knowledge documents that you provide to Dialogflow. Your knowledge documents contain information that may be useful during conversations with end-users. Some Dialogflow features use knowledge bases when looking for a response to an end-user input. For more information, see the [knowledge base guide](https://cloud.google.com/dialogflow/docs/how/knowledge-bases). Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.
+    &quot;languageCode&quot;: &quot;A String&quot;, # Language which represents the KnowledgeBase. When the KnowledgeBase is created/updated, this is populated for all non en-us languages. If not populated, the default language en-us applies.
+    &quot;name&quot;: &quot;A String&quot;, # The knowledge base resource name. The name must be empty when creating a knowledge base. Format: `projects//knowledgeBases/`.
+    &quot;displayName&quot;: &quot;A String&quot;, # Required. The display name of the knowledge base. The name must be 1024 bytes or less; otherwise, the creation request fails.
   }
 
-  updateMask: string, Optional. Not specified means `update all`.
-Currently, only `display_name` can be updated, an InvalidArgument will be
-returned for attempting to update other fields.
+  updateMask: string, Optional. Not specified means `update all`. Currently, only `display_name` can be updated, an InvalidArgument will be returned for attempting to update other fields.
   x__xgafv: string, V1 error format.
     Allowed values
       1 - v1 error format
@@ -338,24 +242,10 @@
 Returns:
   An object of the form:
 
-    { # A knowledge base represents a collection of knowledge documents that you
-        # provide to Dialogflow. Your knowledge documents contain information that may
-        # be useful during conversations with end-users. Some Dialogflow features use
-        # knowledge bases when looking for a response to an end-user input.
-        #
-        # For more information, see the [knowledge base
-        # guide](https://cloud.google.com/dialogflow/docs/how/knowledge-bases).
-        #
-        # Note: The `projects.agent.knowledgeBases` resource is deprecated;
-        # only use `projects.knowledgeBases`.
-      &quot;displayName&quot;: &quot;A String&quot;, # Required. The display name of the knowledge base. The name must be 1024
-          # bytes or less; otherwise, the creation request fails.
-      &quot;name&quot;: &quot;A String&quot;, # The knowledge base resource name.
-          # The name must be empty when creating a knowledge base.
-          # Format: `projects/&lt;Project ID&gt;/knowledgeBases/&lt;Knowledge Base ID&gt;`.
-      &quot;languageCode&quot;: &quot;A String&quot;, # Language which represents the KnowledgeBase. When the KnowledgeBase is
-          # created/updated, this is populated for all non en-us languages. If not
-          # populated, the default language en-us applies.
+    { # A knowledge base represents a collection of knowledge documents that you provide to Dialogflow. Your knowledge documents contain information that may be useful during conversations with end-users. Some Dialogflow features use knowledge bases when looking for a response to an end-user input. For more information, see the [knowledge base guide](https://cloud.google.com/dialogflow/docs/how/knowledge-bases). Note: The `projects.agent.knowledgeBases` resource is deprecated; only use `projects.knowledgeBases`.
+      &quot;languageCode&quot;: &quot;A String&quot;, # Language which represents the KnowledgeBase. When the KnowledgeBase is created/updated, this is populated for all non en-us languages. If not populated, the default language en-us applies.
+      &quot;name&quot;: &quot;A String&quot;, # The knowledge base resource name. The name must be empty when creating a knowledge base. Format: `projects//knowledgeBases/`.
+      &quot;displayName&quot;: &quot;A String&quot;, # Required. The display name of the knowledge base. The name must be 1024 bytes or less; otherwise, the creation request fails.
     }</pre>
 </div>