final edits

Author: pauljewellmsft

articles/storage/blobs/storage-blob-container-create-go.md

@@ -7,7 +7,7 @@ author: pauljewellmsft
 
 ms.service: azure-blob-storage
 ms.topic: how-to
-ms.date: 05/01/2024
+ms.date: 05/22/2024
 ms.author: pauljewell
 ms.devlang: golang
 ms.custom: devx-track-go, devguide-go
@@ -45,7 +45,7 @@ The following example shows how to create a container:
 
 ## Create the root container
 
-A root container serves as a default container for your storage account. Each storage account may have one root container, which must be named *$root*. The root container must be explicitly created or deleted.
+A root container serves as a default container for your storage account. Each storage account can have one root container, which must be named *$root*. The root container must be explicitly created or deleted.
 
 You can reference a blob stored in the root container without including the root container name. The root container enables you to reference a blob at the top level of the storage account hierarchy. For example, you can reference a blob in the root container as follows:
 

articles/storage/blobs/storage-blob-container-delete-go.md

@@ -7,7 +7,7 @@ author: pauljewellmsft
 
 ms.service: azure-blob-storage
 ms.topic: how-to
-ms.date: 05/01/2024
+ms.date: 05/22/2024
 ms.author: pauljewell
 ms.devlang: golang
 ms.custom: devx-track-go, devguide-go
@@ -35,15 +35,15 @@ To delete a container, call the following method:
 
 - [DeleteContainer](https://pkg.go.dev/github.com/Azure/azure-sdk-for-go/sdk/storage/azblob#Client.DeleteContainer)
 
-After you delete a container, you can't create a container with the same name for *at least* 30 seconds. Attempting to create a container with the same name will fail with HTTP error code `409 (Conflict)`. Any other operations on the container or the blobs it contains will fail with HTTP error code `404 (Not Found)`.
+After you delete a container, you can't create a container with the same name for *at least* 30 seconds. Attempting to create a container with the same name fails with HTTP error code `409 (Conflict)`. Any other operations on the container or the blobs it contains fail with HTTP error code `404 (Not Found)`.
 
 The following example shows how to delete a specified container:
 
 :::code language="go" source="~/blob-devguide-go/cmd/delete-container/delete_container.go" id="snippet_delete_container":::
 
 ## Restore a deleted container
 
-When container soft delete is enabled for a storage account, a deleted container and its contents may be recovered within a specified retention period. To learn more about container soft delete, see [Enable and manage soft delete for containers](soft-delete-container-enable.md). You can restore a soft-deleted container by calling the following method from the embedded [ServiceClient](https://pkg.go.dev/github.com/Azure/azure-sdk-for-go/sdk/storage/azblob#Client.ServiceClient) for the client object:
+When container soft delete is enabled for a storage account, a deleted container and its contents can be recovered within a specified retention period. To learn more about container soft delete, see [Enable and manage soft delete for containers](soft-delete-container-enable.md). You can restore a soft-deleted container by calling the following method from the embedded [ServiceClient](https://pkg.go.dev/github.com/Azure/azure-sdk-for-go/sdk/storage/azblob#Client.ServiceClient) for the client object:
 
 - [RestoreContainer](https://pkg.go.dev/github.com/Azure/azure-sdk-for-go/sdk/storage/azblob/service#Client.RestoreContainer)
 

articles/storage/blobs/storage-blob-container-properties-metadata-go.md

@@ -7,7 +7,7 @@ author: pauljewellmsft
 
 ms.service: azure-blob-storage
 ms.topic: how-to
-ms.date: 05/01/2024
+ms.date: 05/22/2024
 ms.author: pauljewell
 ms.devlang: golang
 ms.custom: devx-track-go, devguide-go

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

@@ -7,7 +7,7 @@ author: pauljewellmsft
 
 ms.service: azure-blob-storage
 ms.topic: how-to
-ms.date: 05/01/2024
+ms.date: 05/22/2024
 ms.author: pauljewell
 ms.devlang: golang
 ms.custom: devx-track-go, devguide-go
@@ -43,7 +43,7 @@ You can specify options for listing containers by using the [ListContainersOptio
 
 ### Manage how many results are returned
 
-By default, a listing operation returns up to 5000 results at a time. To return a smaller set of results, provide a nonzero value for the `MaxResults` field in the [ListContainersOptions](https://pkg.go.dev/github.com/Azure/azure-sdk-for-go/sdk/storage/azblob#ListContainersOptions) struct.
+By default, a listing operation returns up to 5,000 results at a time. To return a smaller set of results, provide a nonzero value for the `MaxResults` field in the [ListContainersOptions](https://pkg.go.dev/github.com/Azure/azure-sdk-for-go/sdk/storage/azblob#ListContainersOptions) struct.
 
 ### Filter results with a prefix
 

articles/storage/blobs/storage-blob-delete-go.md

@@ -1,12 +1,12 @@
 ---
 title: Delete and restore a blob with Go
 titleSuffix: Azure Storage
-description: Learn how to delete and restore a blob in your Azure Storage account using the Go client library
+description: Learn how to delete and restore a blob in your Azure Storage account using the Go client library.
 services: storage
 author: pauljewellmsft
 
 ms.author: pauljewell
-ms.date: 05/01/2024
+ms.date: 05/22/2024
 ms.service: azure-blob-storage
 ms.topic: how-to
 ms.devlang: golang
@@ -47,7 +47,7 @@ To delete *only* the snapshots and not the blob itself, you can pass the value `
 
 ## Restore a deleted blob
 
-Blob soft delete protects an individual blob and its versions, snapshots, and metadata from accidental deletes or overwrites by maintaining the deleted data in the system for a specified period of time. During the retention period, you can restore the blob to its state at deletion. After the retention period has expired, the blob is permanently deleted. For more information about blob soft delete, see [Soft delete for blobs](soft-delete-blob-overview.md).
+Blob soft delete protects an individual blob and its versions, snapshots, and metadata from accidental deletes or overwrites by maintaining the deleted data in the system for a specified period of time. During the retention period, you can restore the blob to its state at deletion. After the retention period expires, the blob is permanently deleted. For more information about blob soft delete, see [Soft delete for blobs](soft-delete-blob-overview.md).
 
 You can use the Azure Storage client libraries to restore a soft-deleted blob or snapshot.
 

articles/storage/blobs/storage-blob-download-go.md

@@ -6,7 +6,7 @@ services: storage
 author: pauljewellmsft
 
 ms.author: pauljewell
-ms.date: 05/01/2024
+ms.date: 05/22/2024
 ms.service: azure-blob-storage
 ms.topic: how-to
 ms.devlang: golang
@@ -31,7 +31,7 @@ The authorization mechanism must have the necessary permissions to perform a dow
 
 ## Download a blob
 
-You can use any of the following method to download a blob:
+You can use any of the following methods to download a blob:
 
 - [DownloadBuffer](https://pkg.go.dev/github.com/Azure/azure-sdk-for-go/sdk/storage/azblob#Client.DownloadBuffer)
 - [DownloadFile](https://pkg.go.dev/github.com/Azure/azure-sdk-for-go/sdk/storage/azblob#Client.DownloadFile)

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

@@ -8,7 +8,7 @@ ms.author: pauljewell
 
 ms.service: azure-blob-storage
 ms.topic: how-to
-ms.date: 05/01/2024
+ms.date: 05/22/2024
 ms.devlang: golang
 ms.custom: devx-track-go, devguide-go
 ---
@@ -116,13 +116,13 @@ The following guides show you how to work with data resources and perform specif
 | Guide | Description |
 |--|---|
 | [Create a container](storage-blob-container-create-go.md) | Create containers. |
-| [Delete and restore containers](storage-blob-container-delete-go.md) | Delete containers, and if soft-delete is enabled, restore deleted containers.  |
+| [Delete and restore containers](storage-blob-container-delete-go.md) | Delete containers, and if soft-delete is enabled, restore deleted containers. |
 | [List containers](storage-blob-containers-list-go.md) | List containers in an account and the various options available to customize a listing. |
 | [Manage properties and metadata (containers)](storage-blob-container-properties-metadata-go.md) | Manage container properties and metadata. |
 | [Upload blobs](storage-blob-upload-go.md) | Learn how to upload blobs by using strings, streams, file paths, and other methods. |
 | [Download blobs](storage-blob-download-go.md) | Download blobs by using strings, streams, and file paths. |
 | [List blobs](storage-blobs-list-go.md) | List blobs in different ways. |
-| [Delete and restore blobs](storage-blob-delete-go.md) | Delete blobs, and if soft-delete is enabled, restore deleted blobs.  |
+| [Delete and restore blobs](storage-blob-delete-go.md) | Delete blobs, and if soft-delete is enabled, restore deleted blobs. |
 | [Manage properties and metadata (blobs)](storage-blob-properties-metadata-go.md) | Manage container properties and metadata. |
 
 [!INCLUDE [storage-dev-guide-code-samples-note-go](../../../includes/storage-dev-guides/storage-dev-guide-code-samples-note-go.md)]

articles/storage/blobs/storage-blob-properties-metadata-go.md

@@ -6,7 +6,7 @@ services: storage
 author: pauljewellmsft
 
 ms.author: pauljewell
-ms.date: 05/01/2024
+ms.date: 05/22/2024
 ms.service: azure-blob-storage
 ms.topic: how-to
 ms.devlang: golang

articles/storage/blobs/storage-blob-upload-go.md

@@ -6,7 +6,7 @@ services: storage
 author: pauljewellmsft
 
 ms.author: pauljewell
-ms.date: 05/01/2024
+ms.date: 05/22/2024
 ms.service: azure-blob-storage
 ms.topic: how-to
 ms.devlang: golang
@@ -37,7 +37,7 @@ To upload a blob, call any of the following methods from the client object:
 - [UploadFile](https://pkg.go.dev/github.com/Azure/azure-sdk-for-go/sdk/storage/azblob#Client.UploadFile)
 - [UploadStream](https://pkg.go.dev/github.com/Azure/azure-sdk-for-go/sdk/storage/azblob#Client.UploadStream)
 
-To perform the upload, the client library may use either [Put Blob](/rest/api/storageservices/put-blob) or a series of [Put Block](/rest/api/storageservices/put-block) calls followed by [Put Block List](/rest/api/storageservices/put-block-list). This behavior depends on the overall size of the object and how the data transfer options are set.
+To perform the upload, the client library might use either [Put Blob](/rest/api/storageservices/put-blob) or a series of [Put Block](/rest/api/storageservices/put-block) calls followed by [Put Block List](/rest/api/storageservices/put-block-list). This behavior depends on the overall size of the object and how the data transfer options are set.
 
 ## Upload a block blob from a local file path
 

articles/storage/blobs/storage-quickstart-blobs-go.md

@@ -4,7 +4,7 @@ titleSuffix: Azure Storage
 description: In this quickstart, you learn how to use the Azure Blob Storage client module for Go to create a container and a blob in Blob (object) storage. Next, you learn how to download the blob to your local computer, and how to list all of the blobs in a container.
 author: pauljewellmsft
 ms.author: pauljewell
-ms.date: 08/29/2023
+ms.date: 05/22/2024
 ms.service: azure-blob-storage
 ms.topic: quickstart
 ms.devlang: golang
@@ -175,6 +175,8 @@ _, err = client.CreateContainer(ctx, containerName, nil)
 handleError(err)
 ```
 
+To learn more about creating a container, and to explore more code samples, see [Create a blob container with Go](storage-blob-container-create-go.md).
+
 ### Upload blobs to the container
 
 The code sample creates a byte array with some data, and uploads the data as a buffer to a new blob resource in the specified container. 
@@ -191,6 +193,8 @@ _, err = client.UploadBuffer(ctx, containerName, blobName, data, &azblob.UploadB
 handleError(err)
 ```
 
+To learn more about uploading blobs, and to explore more code samples, see [Upload a blob with Go](storage-blob-upload-go.md).
+
 ### List the blobs in a container
 
 The code sample lists the blobs in the specified container. This example uses [NewListBlobsFlatPager](https://pkg.go.dev/github.com/Azure/azure-sdk-for-go/sdk/storage/azblob#Client.NewListBlobsFlatPager), which returns a pager for blobs starting from the specified Marker. Here, we use an empty Marker to start enumeration from the beginning, and continue paging until there are no more results. This method returns blob names in lexicographic order.
@@ -215,6 +219,8 @@ for pager.More() {
 }
 ```
 
+To learn more about listing blobs, and to explore more code examples, see [List blobs with Go](storage-blob-list-go.md).
+
 ### Download the blob
 
 The code sample downloads a blob using the [DownloadStream](https://pkg.go.dev/github.com/Azure/azure-sdk-for-go/sdk/storage/azblob#Client.DownloadStream) method, and creates a retry reader for reading data. If a connection fails while reading, the retry reader makes other requests to re-establish a connection and continue reading. You can specify retry reader options using the [RetryReaderOptions](https://pkg.go.dev/github.com/Azure/azure-sdk-for-go/sdk/storage/azblob/blob#RetryReaderOptions) struct.
@@ -239,6 +245,8 @@ fmt.Println("Blob contents:")
 fmt.Println(downloadedData.String())
 ```
 
+To learn more about downloading blobs, and to explore more code examples, see [Download a blob with Go](storage-blob-download-go.md).
+
 ### Clean up resources
 
 If you no longer need the blobs uploaded in this quickstart, you can delete the individual blob using the [DeleteBlob](https://pkg.go.dev/github.com/Azure/azure-sdk-for-go/sdk/storage/azblob#Client.DeleteBlob) method, or the entire container and its contents using the [DeleteContainer](https://pkg.go.dev/github.com/Azure/azure-sdk-for-go/sdk/storage/azblob#Client.DeleteContainer) method.
@@ -256,6 +264,8 @@ _, err = client.DeleteContainer(ctx, containerName, nil)
 handleError(err)
 ```
 
+To learn more about deleting blobs and containers, and to explore more code examples, see [Delete a blob with Go](storage-blob-delete-go.md) and [Delete a container with Go](storage-blob-container-delete-go.md).
+
 ## Next steps
 
 In this quickstart, you learned how to upload, download, and list blobs using Go.