Clarify and expand docstrings. (#187)

## Problem

Current plans to automate Python client documentation generation consume
client docstrings. Some of these strings are currently incomplete or
unclear.

## Solution

This PR expands and clarifies the docstrings in the Python client.

## Type of Change

- [ ] Bug fix (non-breaking change which fixes an issue)
- [ ] New feature (non-breaking change which adds functionality)
- [ ] Breaking change (fix or feature that would cause existing
functionality to not work as expected)
- [ ] This change requires a documentation update
- [ ] Infrastructure change (CI configs, etc)
- [x ] Non-code change (docs, etc)
- [ ] None of the above: (explain here)

Author: byronnlandry

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