Clarify and expand docstrings.

pinecone/core/client/api/index_operations_api.py

@@ -3,13 +3,11 @@
 #
 
 """
-    Pinecone API
+    Pinecone index operations API
 
-    No description provided (generated by Openapi Generator https://github.com/openapitools/openapi-generator)  # noqa: E501
+      # noqa: E501
 
-    The version of the OpenAPI document: version not set
     Contact: [email protected]
-    Generated by: https://openapi-generator.tech
 """
 
 
@@ -188,7 +186,7 @@ def __create_collection(
         ):
             """create_collection  # noqa: E501
 
-            This operation creates a Pinecone collection.  # noqa: E501
+            This operation creates a Pinecone collection from an existing index.  # noqa: E501
             This method makes a synchronous HTTP request by default. To make an
             asynchronous HTTP request, please pass async_req=True
 
@@ -313,7 +311,7 @@ def __create_index(
         ):
             """create_index  # noqa: E501
 
-            This operation creates a Pinecone index. You can use it to specify the measure of similarity, the dimension of vectors to be stored in the index, the numbers of shards and replicas to use, and more.  # noqa: E501
+            This operation creates a Pinecone index. Specify the distance metric, the dimension of vectors to be stored in the index, the numbers replicas to use, and the collection from which to create the index, if applicable.  # noqa: E501
             This method makes a synchronous HTTP request by default. To make an
             asynchronous HTTP request, please pass async_req=True
 
@@ -699,7 +697,7 @@ def __describe_collection(
         ):
             """describe_collection  # noqa: E501
 
-            Get a description of a collection.  # noqa: E501
+            Get a description of a collection, including the name, size, and status.  # noqa: E501
             This method makes a synchronous HTTP request by default. To make an
             asynchronous HTTP request, please pass async_req=True
 
@@ -829,7 +827,7 @@ def __describe_index(
         ):
             """describe_index  # noqa: E501
 
-            Get a description of an index.  # noqa: E501
+            Get a description of an index, including dimension, distance metric, number of replicas, and more.  # noqa: E501
             This method makes a synchronous HTTP request by default. To make an
             asynchronous HTTP request, please pass async_req=True
 
@@ -1076,7 +1074,7 @@ def __list_indexes(
         ):
             """list_indexes  # noqa: E501
 
-            This operation returns a list of your Pinecone indexes.  # noqa: E501
+            This operation returns a list of the indexes in the current project.  # noqa: E501
             This method makes a synchronous HTTP request by default. To make an
             asynchronous HTTP request, please pass async_req=True