Review pass

Author: pauljewellmsft

articles/storage/blobs/storage-blob-container-lease-python.md

@@ -1,7 +1,7 @@
 ---
-title: Create and manage blob or container leases with Python
+title: Create and manage container leases with Python
 titleSuffix: Azure Storage
-description: Learn how to manage a lock on a blob or container in your Azure Storage account using the Python client library.
+description: Learn how to manage a lock on a container in your Azure Storage account using the Python client library.
 services: storage
 author: pauljewellmsft
 ms.author: pauljewell
@@ -14,7 +14,7 @@ ms.devlang: python
 ms.custom: devx-track-python, devguide-python
 ---
 
-# Create and manage blob container leases with Python
+# Create and manage container leases with Python
 
 This article shows how to create and manage container leases using the [Azure Storage client library for Python](/python/api/overview/azure/storage).
 
@@ -24,11 +24,15 @@ You can use the Python client library to acquire, renew, release and break lease
 
 ## Acquire a lease
 
-When you acquire a lease, you'll obtain a lease ID that your code can use to operate on the blob or container. To acquire a lease, create an instance of the [BlobLeaseClient](/python/api/azure-storage-blob/azure.storage.blob.blobleaseclient) class, and then use the following method:
+When you acquire a lease, you'll obtain a lease ID that your code can use to operate on the container. To acquire a lease, create an instance of the [BlobLeaseClient](/python/api/azure-storage-blob/azure.storage.blob.blobleaseclient) class, and then use the following method:
 
 - [BlobLeaseClient.acquire](/python/api/azure-storage-blob/azure.storage.blob.blobleaseclient#azure-storage-blob-blobleaseclient-acquire)
 
-The following example acquires a 30-second lease for a blob:
+You can also acquire a lease using the following method from the [ContainerClient](/python/api/azure-storage-blob/azure.storage.blob.containerclient) class:
+
+- [ContainerClient.acquire_lease](/python/api/azure-storage-blob/azure.storage.blob.containerclient#azure-storage-blob-containerclient-acquire-lease)
+
+The following example acquires a 30-second lease on a container:
 
 :::code language="python" source="~/azure-storage-snippets/blobs/howto/python/blob-devguide-py/blob-devguide-containers.py" id="Snippet_acquire_container_lease":::
 
@@ -38,7 +42,7 @@ If your lease expires, you can renew it. To renew a lease, use the following met
 
 - [BlobLeaseClient.renew](/python/api/azure-storage-blob/azure.storage.blob.blobleaseclient#azure-storage-blob-blobleaseclient-renew)
 
-The following example renews a lease for a blob:
+The following example renews a lease for a container:
 
 :::code language="python" source="~/azure-storage-snippets/blobs/howto/python/blob-devguide-py/blob-devguide-containers.py" id="Snippet_renew_container_lease":::
 
@@ -48,7 +52,7 @@ You can either wait for a lease to expire or explicitly release it. When you rel
 
 - [BlobLeaseClient.release](/python/api/azure-storage-blob/azure.storage.blob.blobleaseclient#azure-storage-blob-blobleaseclient-release)
 
-The following example releases the lease on a blob:
+The following example releases the lease on a container:
 
 :::code language="python" source="~/azure-storage-snippets/blobs/howto/python/blob-devguide-py/blob-devguide-containers.py" id="Snippet_release_container_lease":::
 
@@ -58,7 +62,7 @@ When you break a lease, the lease ends, but other clients can't acquire a lease
 
 - [BlobLeaseClient.break_lease](/python/api/azure-storage-blob/azure.storage.blob.blobleaseclient#azure-storage-blob-blobleaseclient-break-lease)
 
-The following example breaks the lease on a blob:
+The following example breaks the lease on a container:
 
 :::code language="python" source="~/azure-storage-snippets/blobs/howto/python/blob-devguide-py/blob-devguide-containers.py" id="Snippet_break_container_lease":::
 

articles/storage/blobs/storage-blob-containers-list-python.md

@@ -34,15 +34,15 @@ To filter the list of containers, specify a string or character for the `name_st
 
 ## Code examples
 
-The following example lists all containers names and any associated metadata:
+The following example lists all containers and metadata. You can include container metadata by setting `include_metadata` to :
 
 :::code language="python" source="~/azure-storage-snippets/blobs/howto/python/blob-devguide-py/blob-devguide-containers.py" id="Snippet_list_containers":::
 
-The following example lists only containers that begin with a specified prefix:
+The following example lists only containers that begin with a prefix specified in the `name_starts_with` parameter:
 
 :::code language="python" source="~/azure-storage-snippets/blobs/howto/python/blob-devguide-py/blob-devguide-containers.py" id="Snippet_list_containers_prefix":::
 
-You can also specify a limit for the number of results per page:
+You can also specify a limit for the number of results per page. This example passes in `results_per_page` and paginates the results:
 
 :::code language="python" source="~/azure-storage-snippets/blobs/howto/python/blob-devguide-py/blob-devguide-containers.py" id="Snippet_list_containers_pages":::
 

articles/storage/blobs/storage-blob-python-get-started.md

@@ -15,17 +15,36 @@ ms.custom: devx-track-python, devguide-python
 
 # Get started with Azure Blob Storage and Python
 
-This article shows you how to connect to Azure Blob Storage by using the Azure Blob Storage client library Python. Once connected, your code can operate on containers, blobs, and features of the Blob Storage service.
+This article shows you how to connect to Azure Blob Storage by using the Azure Blob Storage client library for Python. Once connected, your code can operate on containers, blobs, and features of the Blob Storage service.
 
 [API reference documentation](/python/api/azure-storage-blob) | [Library source code](https://github.com/Azure/azure-sdk-for-python/tree/master/sdk/storage/azure-storage-blob) | [Package (PyPi)](https://pypi.org/project/azure-storage-blob/) | [Samples](../common/storage-samples-python.md?toc=/azure/storage/blobs/toc.json#blob-samples)
 
 ## Prerequisites
 
 - Azure subscription - [create one for free](https://azure.microsoft.com/free/)
 - Azure storage account - [create a storage account](../common/storage-account-create.md)
+- [Python](https://www.python.org/downloads/) 3.6+
 
 ## Set up your project
 
+This section walks you through preparing a project to work with the Azure Blob Storage client library for Python.
+
+From your project directory, install packages for the Azure Blob Storage and Azure Identity client libraries using the `pip install` command. The **azure-identity** package is needed for passwordless connections to Azure services.
+
+```console
+pip install azure-storage-blob azure-identity
+```
+
+Then open your code file and add the necessary import statements. In this example, we add the following to our *.py* file:
+
+```python
+from azure.identity import DefaultAzureCredential
+from azure.storage.blob import BlobServiceClient, BlobClient, ContainerClient
+```
+
+Blob client library information:
+- [azure.storage.blob](/python/api/azure-storage-blob/azure.storage.blob): Contains the primary classes (_client objects_) that you can use to operate on the service, containers, and blobs.
+
 ## Authorize access and connect to Blob Storage
 
 To connect to Blob Storage, create an instance of the [BlobServiceClient](/python/api/azure-storage-blob/azure.storage.blob.blobserviceclient) class. This object is your starting point. You can use it to operate on the blob service instance and its containers. You can create a `BlobServiceClient` object by using an Azure Active Directory (Azure AD) authorization token, an account access key, or a shared access signature (SAS).