Update metadata, H1s, and intros for consistency across languages

pauljewellmsft · pauljewellmsft · commit 0e7d04849ab6 · 2023-01-31T13:41:09.000-05:00
diff --git a/articles/storage/blobs/storage-blob-container-create-java.md b/articles/storage/blobs/storage-blob-container-create-java.md
@@ -1,5 +1,6 @@
 ---
-title: Create a blob container with Java - Azure Storage 
+title: Create a blob container with Java
+titleSuffix: Azure Storage
 description: Learn how to create a blob container in your Azure Storage account using the Java client library.
 services: storage
 author: pauljewellmsft
@@ -13,7 +14,7 @@ ms.devlang: java
 ms.custom: devx-track-java, devguide-java
 ---
 
-# Create a container in Azure Storage using the Java client library
+# Create a blob container with Java
 
 Blobs in Azure Storage are organized into containers. Before you can upload a blob, you must first create a container. This article shows how to create containers with the [Azure Storage client library for Java](/java/api/overview/azure/storage-blob-readme).
 
diff --git a/articles/storage/blobs/storage-blob-container-create-javascript.md b/articles/storage/blobs/storage-blob-container-create-javascript.md
@@ -13,7 +13,7 @@ ms.devlang: javascript
 ms.custom: devx-track-js, devguide-js
 ---
 
-# Create a container in Azure Storage with JavaScript
+# Create a blob container with JavaScript
 
 Blobs in Azure Storage are organized into containers. Before you can upload a blob, you must first create a container. This article shows how to create containers with the [Azure Storage client library for JavaScript](https://www.npmjs.com/package/@azure/storage-blob).
 
diff --git a/articles/storage/blobs/storage-blob-container-create.md b/articles/storage/blobs/storage-blob-container-create.md
@@ -14,7 +14,7 @@ ms.devlang: csharp
 ms.custom: devx-track-csharp, devguide-csharp
 ---
 
-# Create a container in Azure Storage with .NET
+# Create a blob container with .NET
 
 Blobs in Azure Storage are organized into containers. Before you can upload a blob, you must first create a container. This article shows how to create containers with the [Azure Storage client library for .NET](/dotnet/api/overview/azure/storage).
 
diff --git a/articles/storage/blobs/storage-blob-container-delete-java.md b/articles/storage/blobs/storage-blob-container-delete-java.md
@@ -1,5 +1,6 @@
 ---
-title: Delete and restore a blob container with Java - Azure Storage 
+title: Delete and restore a blob container with Java
+titleSuffix: Azure Storage
 description: Learn how to delete and restore a blob container in your Azure Storage account using the Java client library.
 services: storage
 author: pauljewellmsft
@@ -13,7 +14,7 @@ ms.devlang: java
 ms.custom: devx-track-java, devguide-java
 ---
 
-# Delete and restore a container in Azure Storage using the Java client library
+# Delete and restore a blob container with Java
 
 This article shows how to delete containers with the [Azure Storage client library for Java](/java/api/overview/azure/storage-blob-readme). If you've enabled [container soft delete](soft-delete-container-overview.md), you can restore deleted containers.
 
diff --git a/articles/storage/blobs/storage-blob-container-delete-javascript.md b/articles/storage/blobs/storage-blob-container-delete-javascript.md
@@ -14,9 +14,9 @@ ms.devlang: javascript
 ms.custom: devx-track-js, devguide-js
 ---
 
-# Delete and restore a container in Azure Storage with JavaScript
+# Delete and restore a blob container with JavaScript
 
-This article shows how to delete containers with the [Azure Storage client library for JavaScript](https://www.npmjs.com/package/@azure/storage-blob). If you've enabled container soft delete, you can restore deleted containers.
+This article shows how to delete containers with the [Azure Storage client library for JavaScript](https://www.npmjs.com/package/@azure/storage-blob).  If you've enabled [container soft delete](soft-delete-container-overview.md), you can restore deleted containers.
 
 The [sample code snippets](https://github.com/Azure-Samples/AzureStorageSnippets/tree/master/blobs/howto/JavaScript/NodeJS-v12/dev-guide) are available in GitHub as runnable Node.js files.
 
diff --git a/articles/storage/blobs/storage-blob-container-delete.md b/articles/storage/blobs/storage-blob-container-delete.md
@@ -15,9 +15,9 @@ ms.devlang: csharp
 ms.custom: devx-track-csharp, devguide-csharp
 ---
 
-# Delete and restore a container in Azure Storage with .NET
+# Delete and restore a blob container with .NET
 
-This article shows how to delete containers with the [Azure Storage client library for .NET](/dotnet/api/overview/azure/storage). If you've enabled container soft delete, you can restore deleted containers.
+This article shows how to delete containers with the [Azure Storage client library for .NET](/dotnet/api/overview/azure/storage). If you've enabled [container soft delete](soft-delete-container-overview.md), you can restore deleted containers.
 
 > [!NOTE]
 > The examples in this article assume that you've created a [BlobServiceClient](/dotnet/api/azure.storage.blobs.blobserviceclient) object by using the guidance in the [Get started with Azure Blob Storage and .NET](storage-blob-dotnet-get-started.md) article.
diff --git a/articles/storage/blobs/storage-blob-container-lease-java.md b/articles/storage/blobs/storage-blob-container-lease-java.md
@@ -1,5 +1,6 @@
 ---
-title: Create and manage container leases with Java - Azure Storage 
+title: Create and manage container leases with Java
+titleSuffix: Azure Storage
 description: Learn how to manage a lock on a container in your Azure Storage account using the Java client library.
 services: storage
 author: pauljewellmsft
diff --git a/articles/storage/blobs/storage-blob-container-properties-metadata-java.md b/articles/storage/blobs/storage-blob-container-properties-metadata-java.md
@@ -23,7 +23,7 @@ Blob containers support system properties and user-defined metadata, in addition
 
 - **User-defined metadata**: User-defined metadata consists of one or more name-value pairs that you specify for a Blob storage resource. You can use metadata to store additional values with the resource. Metadata values are for your own purposes only, and don't affect how the resource behaves.
 
-- **Metadata names**: Metadata name/value pairs are valid HTTP headers and should adhere to all restrictions governing HTTP headers. For more information about metadata naming requirements, see [Metadata names](/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata#metadata-names).
+    Metadata name/value pairs are valid HTTP headers and should adhere to all restrictions governing HTTP headers. For more information about metadata naming requirements, see [Metadata names](/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata#metadata-names).
 
 ## Retrieve container properties
 
diff --git a/articles/storage/blobs/storage-blob-container-properties-metadata-javascript.md b/articles/storage/blobs/storage-blob-container-properties-metadata-javascript.md
@@ -24,7 +24,7 @@ Blob containers support system properties and user-defined metadata, in addition
 
 - **User-defined metadata**: User-defined metadata consists of one or more name-value pairs that you specify for a Blob storage resource. You can use metadata to store additional values with the resource. Metadata values are for your own purposes only, and do not affect how the resource behaves.
 
-- **Metadata names**: Metadata name/value pairs are valid HTTP headers and should adhere to all restrictions governing HTTP headers. For more information about metadata naming requirements, see [Metadata names](/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata#metadata-names).
+    Metadata name/value pairs are valid HTTP headers and should adhere to all restrictions governing HTTP headers. For more information about metadata naming requirements, see [Metadata names](/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata#metadata-names).
 
 ## Retrieve container properties
 
diff --git a/articles/storage/blobs/storage-blob-container-properties-metadata-python.md b/articles/storage/blobs/storage-blob-container-properties-metadata-python.md
@@ -23,7 +23,7 @@ Blob containers support system properties and user-defined metadata, in addition
 
 - **User-defined metadata**: User-defined metadata consists of one or more name-value pairs that you specify for a Blob storage resource. You can use metadata to store additional values with the resource. Metadata values are for your own purposes only, and don't affect how the resource behaves.
 
-- **Metadata names**: Metadata name/value pairs are valid HTTP headers and should adhere to all restrictions governing HTTP headers. For more information about metadata naming requirements, see [Metadata names](/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata#metadata-names).
+    Metadata name/value pairs are valid HTTP headers and should adhere to all restrictions governing HTTP headers. For more information about metadata naming requirements, see [Metadata names](/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata#metadata-names).
 
 ## Retrieve container properties
 
diff --git a/articles/storage/blobs/storage-blob-containers-list-java.md b/articles/storage/blobs/storage-blob-containers-list-java.md
@@ -14,7 +14,7 @@ ms.devlang: java
 ms.custom: devx-track-java, devguide-java
 ---
 
-# List blob containers using the Java client library
+# List blob containers with Java
 
 When you list the containers in an Azure Storage account from your code, you can specify several options to manage how results are returned from Azure Storage. This article shows how to list containers using the [Azure Storage client library for Java](/java/api/overview/azure/storage-blob-readme).
 
diff --git a/articles/storage/blobs/storage-blob-copy-java.md b/articles/storage/blobs/storage-blob-copy-java.md
@@ -14,9 +14,9 @@ ms.devlang: java
 ms.custom: devx-track-java, devguide-java
 ---
 
-# Copy a blob using the Java client library
+# Copy a blob with Java
 
-This article demonstrates how to copy a blob in an Azure Storage account. It also shows how to abort a copy operation. The example code uses the [Azure Storage client library for Java](/java/api/overview/azure/storage-blob-readme).
+This article shows how to copy a blob in a storage account using the [Azure Storage client library for Java](/java/api/overview/azure/storage-blob-readme). It also shows how to abort a pending copy operation.
 
 ## About copying blobs
 
diff --git a/articles/storage/blobs/storage-blob-copy-javascript.md b/articles/storage/blobs/storage-blob-copy-javascript.md
@@ -13,9 +13,9 @@ ms.devlang: javascript
 ms.custom: devx-track-js, devguide-js
 ---
 
-# Copy a blob with Azure Storage using the JavaScript client library
+# Copy a blob with JavaScript
 
-This article demonstrates how to copy a blob in an Azure Storage account. It also shows how to abort an asynchronous copy operation. The example code uses the Azure Storage client libraries.
+This article shows how to copy a blob in a storage account using the [Azure Storage client library for JavaScript](https://www.npmjs.com/package/@azure/storage-blob). It also shows how to abort an asynchronous copy operation.
 
 The [sample code snippets](https://github.com/Azure-Samples/AzureStorageSnippets/tree/master/blobs/howto/JavaScript/NodeJS-v12/dev-guide) are available in GitHub as runnable Node.js files.
 
diff --git a/articles/storage/blobs/storage-blob-copy.md b/articles/storage/blobs/storage-blob-copy.md
@@ -13,9 +13,9 @@ ms.devlang: csharp
 ms.custom: devx-track-csharp, devguide-csharp
 ---
 
-# Copy a blob with Azure Storage using the .NET client library
+# Copy a blob with .NET
 
-This article demonstrates how to copy a blob in an Azure Storage account. It also shows how to abort an asynchronous copy operation. The example code uses the Azure Storage client libraries.
+This article shows how to copy a blob in a storage account using the [Azure Storage client library for .NET](/dotnet/api/overview/azure/storage). It also shows how to abort an asynchronous copy operation.
 
 ## About copying blobs
 
diff --git a/articles/storage/blobs/storage-blob-delete-java.md b/articles/storage/blobs/storage-blob-delete-java.md
@@ -14,9 +14,9 @@ ms.devlang: java
 ms.custom: devx-track-java, devguide-java
 ---
 
-# Delete a blob with the Java client library
+# Delete and restore a blob with Java
 
-This article shows how to delete blobs with the [Azure Storage client library for Java](/java/api/overview/azure/storage-blob-readme). If you've enabled blob soft delete, you can restore deleted blobs.
+This article shows how to delete blobs with the [Azure Storage client library for Java](/java/api/overview/azure/storage-blob-readme).  If you've enabled [soft delete for blobs](soft-delete-blob-overview.md), you can restore deleted blobs during the retention period.
 
 ## Delete a blob
 
diff --git a/articles/storage/blobs/storage-blob-delete-javascript.md b/articles/storage/blobs/storage-blob-delete-javascript.md
@@ -13,9 +13,9 @@ ms.devlang: javascript
 ms.custom: devx-track-js, devguide-js
 ---
 
-# Delete and restore a blob in your Azure Storage account using the JavaScript client library
+# Delete and restore a blob with JavaScript
 
-This article shows how to delete blobs with the [Azure Storage client library for JavaScript](https://www.npmjs.com/package/@azure/storage-blob). If you've enabled blob soft delete, you can restore deleted blobs.
+This article shows how to delete blobs with the [Azure Storage client library for JavaScript](https://www.npmjs.com/package/@azure/storage-blob). If you've enabled [soft delete for blobs](soft-delete-blob-overview.md), you can restore deleted blobs during the retention period.
 
 The [sample code snippets](https://github.com/Azure-Samples/AzureStorageSnippets/tree/master/blobs/howto/JavaScript/NodeJS-v12/dev-guide) are available in GitHub as runnable Node.js files.
 
diff --git a/articles/storage/blobs/storage-blob-delete.md b/articles/storage/blobs/storage-blob-delete.md
@@ -13,9 +13,9 @@ ms.devlang: csharp
 ms.custom: devx-track-csharp, devguide-csharp
 ---
 
-# Delete and restore a blob in your Azure Storage account using the .NET client library
+# Delete and restore a blob with .NET
 
-This article shows how to delete blobs with the [Azure Storage client library for .NET](/dotnet/api/overview/azure/storage). If you've enabled blob soft delete, you can restore deleted blobs.
+This article shows how to delete blobs with the [Azure Storage client library for .NET](/dotnet/api/overview/azure/storage). If you've enabled [soft delete for blobs](soft-delete-blob-overview.md), you can restore deleted blobs during the retention period.
 
 ## Delete a blob
 
diff --git a/articles/storage/blobs/storage-blob-download-java.md b/articles/storage/blobs/storage-blob-download-java.md
@@ -14,9 +14,9 @@ ms.devlang: java
 ms.custom: devx-track-java, devguide-java
 ---
 
-# Download a blob in Azure Storage using the Java client library
+# Download a blob with Java
 
-This article shows how to download a blob with the [Azure Storage client library for Java](/java/api/overview/azure/storage-blob-readme). You can download a blob by using any of the following methods:
+This article shows how to download a blob using the [Azure Storage client library for Java](/java/api/overview/azure/storage-blob-readme). You can download a blob by using any of the following methods:
 
 - [downloadContent](/java/api/com.azure.storage.blob.specialized.blobclientbase)
 - [downloadStream](/java/api/com.azure.storage.blob.specialized.blobclientbase)
diff --git a/articles/storage/blobs/storage-blob-download-javascript.md b/articles/storage/blobs/storage-blob-download-javascript.md
@@ -13,13 +13,13 @@ ms.devlang: javascript
 ms.custom: devx-track-js, devguide-js
 ---
 
-# Download a blob in Azure Storage using the JavaScript client library
+# Download a blob with JavaScript
 
-Create a [BlobClient](storage-blob-javascript-get-started.md#create-a-blobclient-object) then download a blob by using any of the following methods:
+This article shows how to download a blob using the [Azure Storage client library for JavaScript](https://www.npmjs.com/package/@azure/storage-blob). You can download a blob by using any of the following methods:
 
-- Blob.[download](/javascript/api/@azure/storage-blob/blobclient#@azure-storage-blob-blobclient-download)
-- Blob.[downloadToBuffer](/javascript/api/@azure/storage-blob/blobclient#@azure-storage-blob-blobclient-downloadtobuffer-1) (only available in Node.js runtime)
-- Blob.[downloadToFile](/javascript/api/@azure/storage-blob/blobclient#@azure-storage-blob-blobclient-downloadtofile) (only available in Node.js runtime)
+- [BlobClient.download](/javascript/api/@azure/storage-blob/blobclient#@azure-storage-blob-blobclient-download)
+- [BlobClient.downloadToBuffer](/javascript/api/@azure/storage-blob/blobclient#@azure-storage-blob-blobclient-downloadtobuffer-1) (only available in Node.js runtime)
+- [BlobClient.downloadToFile](/javascript/api/@azure/storage-blob/blobclient#@azure-storage-blob-blobclient-downloadtofile) (only available in Node.js runtime)
 
 The [sample code snippets](https://github.com/Azure-Samples/AzureStorageSnippets/tree/master/blobs/howto/JavaScript/NodeJS-v12/dev-guide) are available in GitHub as runnable Node.js files.
 
diff --git a/articles/storage/blobs/storage-blob-download.md b/articles/storage/blobs/storage-blob-download.md
@@ -13,9 +13,9 @@ ms.devlang: csharp
 ms.custom: devx-track-csharp, devguide-csharp
 ---
 
-# Download a blob in Azure Storage using the .NET client library
+# Download a blob with .NET
 
-You can download a blob by using any of the following methods:
+This article shows how to download a blob using the [Azure Storage client library for .NET](/dotnet/api/overview/azure/storage). You can download a blob by using any of the following methods:
 
 - [DownloadTo](/dotnet/api/azure.storage.blobs.specialized.blobbaseclient.downloadto)
 - [DownloadToAsync](/dotnet/api/azure.storage.blobs.specialized.blobbaseclient.downloadtoasync)
diff --git a/articles/storage/blobs/storage-blob-get-url-javascript.md b/articles/storage/blobs/storage-blob-get-url-javascript.md
@@ -1,5 +1,5 @@
 ---
-title: Get container and blob urlJavaScript
+title: Get container and blob url with JavaScript
 titleSuffix: Azure Storage
 description: Learn how to get a container or blob URL in Azure Storage by using the JavaScript client library.
 services: storage
@@ -13,7 +13,7 @@ ms.devlang: javascript
 ms.custom: devx-track-js, devguide-js
 ---
 
-# Get URL for container or blob in Azure Storage using the JavaScript client library
+# Get URL for container or blob with JavaScript
 
 You can get a container or blob URL by using the `url` property of the client object:
 
diff --git a/articles/storage/blobs/storage-blob-lease-java.md b/articles/storage/blobs/storage-blob-lease-java.md
@@ -1,5 +1,6 @@
 ---
-title: Create and manage blob leases with Java - Azure Storage 
+title: Create and manage blob leases with Java
+titleSuffix: Azure Storage
 description: Learn how to manage a lock on a blob in your Azure Storage account using the Java client library.
 services: storage
 author: pauljewellmsft
diff --git a/articles/storage/blobs/storage-blob-properties-metadata-java.md b/articles/storage/blobs/storage-blob-properties-metadata-java.md
@@ -24,7 +24,7 @@ In addition to the data they contain, blobs support system properties and user-d
 
 - **User-defined metadata**: User-defined metadata consists of one or more name-value pairs that you specify for a Blob storage resource. You can use metadata to store additional values with the resource. Metadata values are for your own purposes only, and don't affect how the resource behaves.
 
-- **Metadata names**: Metadata name/value pairs are valid HTTP headers and should adhere to all restrictions governing HTTP headers. For more information about metadata naming requirements, see [Metadata names](/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata#metadata-names).
+    Metadata name/value pairs are valid HTTP headers and should adhere to all restrictions governing HTTP headers. For more information about metadata naming requirements, see [Metadata names](/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata#metadata-names).
 
 > [!NOTE]
 > Blob index tags also provide the ability to store arbitrary user-defined key/value attributes alongside an Azure Blob storage resource. While similar to metadata, only blob index tags are automatically indexed and made searchable by the native blob service. Metadata cannot be indexed and queried unless you utilize a separate service such as Azure Search.
diff --git a/articles/storage/blobs/storage-blob-properties-metadata-javascript.md b/articles/storage/blobs/storage-blob-properties-metadata-javascript.md
@@ -25,7 +25,7 @@ The [sample code snippets](https://github.com/Azure-Samples/AzureStorageSnippets
 
 - **User-defined metadata**: User-defined metadata consists of one or more name-value pairs that you specify for a Blob storage resource. You can use metadata to store additional values with the resource. Metadata values are for your own purposes only, and don't affect how the resource behaves.
 
-- **Metadata names**: Metadata name/value pairs are valid HTTP headers and should adhere to all restrictions governing HTTP headers. For more information about metadata naming requirements, see [Metadata names](/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata#metadata-names).
+    Metadata name/value pairs are valid HTTP headers and should adhere to all restrictions governing HTTP headers. For more information about metadata naming requirements, see [Metadata names](/rest/api/storageservices/naming-and-referencing-containers--blobs--and-metadata#metadata-names).
 
 > [!NOTE]
 > Blob index tags also provide the ability to store arbitrary user-defined key/value attributes alongside an Azure Blob storage resource. While similar to metadata, only blob index tags are automatically indexed and made searchable by the native blob service. Metadata cannot be indexed and queried unless you utilize a separate service such as Azure Search.
diff --git a/articles/storage/blobs/storage-blob-properties-metadata.md b/articles/storage/blobs/storage-blob-properties-metadata.md
diff --git a/articles/storage/blobs/storage-blob-tags-java.md b/articles/storage/blobs/storage-blob-tags-java.md
diff --git a/articles/storage/blobs/storage-blob-tags-javascript.md b/articles/storage/blobs/storage-blob-tags-javascript.md
diff --git a/articles/storage/blobs/storage-blob-tags-python.md b/articles/storage/blobs/storage-blob-tags-python.md
diff --git a/articles/storage/blobs/storage-blob-tags.md b/articles/storage/blobs/storage-blob-tags.md
diff --git a/articles/storage/blobs/storage-blob-upload-java.md b/articles/storage/blobs/storage-blob-upload-java.md
diff --git a/articles/storage/blobs/storage-blob-upload-javascript.md b/articles/storage/blobs/storage-blob-upload-javascript.md
diff --git a/articles/storage/blobs/storage-blob-upload.md b/articles/storage/blobs/storage-blob-upload.md
diff --git a/articles/storage/blobs/storage-blobs-list-java.md b/articles/storage/blobs/storage-blobs-list-java.md
diff --git a/articles/storage/blobs/storage-blobs-list-javascript.md b/articles/storage/blobs/storage-blobs-list-javascript.md
diff --git a/articles/storage/blobs/storage-blobs-list.md b/articles/storage/blobs/storage-blobs-list.md
