Add include files

pauljewellmsft · pauljewellmsft · commit 12bcad3ea822 · 2023-04-21T16:18:26.000-04:00
diff --git a/articles/storage/blobs/storage-blob-download-java.md b/articles/storage/blobs/storage-blob-download-java.md
@@ -27,9 +27,7 @@ To work with the code examples in this article, make sure you have:
     - [Get Blob](/rest/api/storageservices/get-blob#authorization)
 - The package **azure-storage-blob** installed to your project directory. To learn more about setting up your project, see [Get Started with Azure Storage and Java](storage-blob-java-get-started.md#set-up-your-project).
 
-## About downloading blobs
-
-The [Get Blob](/rest/api/storageservices/put-blob) operation reads or downloads a blob from Azure Storage, including its metadata and properties. To learn more about the `Get Blob` operation, including timeout parameters and error conditions, see [Get Blob remarks](/rest/api/storageservices/get-blob#remarks).
+[!INCLUDE [storage-dev-guide-about-blob-download](../../../includes/storage-dev-guides/storage-dev-guide-about-blob-download.md)]
 
 ## Download a blob
 
diff --git a/articles/storage/blobs/storage-blob-download-javascript.md b/articles/storage/blobs/storage-blob-download-javascript.md
@@ -27,9 +27,7 @@ To work with the code examples in this article, make sure you have:
     - [Get Blob](/rest/api/storageservices/get-blob#authorization)
 - The package **@azure/storage-blob** installed to your project directory. To learn more about setting up your project, see [Get started with Azure Blob Storage and JavaScript](storage-blob-javascript-get-started.md).
 
-## About downloading blobs
-
-The [Get Blob](/rest/api/storageservices/put-blob) operation reads or downloads a blob from Azure Storage, including its metadata and properties. To learn more about the `Get Blob` operation, including timeout parameters and error conditions, see [Get Blob remarks](/rest/api/storageservices/get-blob#remarks).
+[!INCLUDE [storage-dev-guide-about-blob-download](../../../includes/storage-dev-guides/storage-dev-guide-about-blob-download.md)]
 
 ## Download a blob
 
diff --git a/articles/storage/blobs/storage-blob-download-python.md b/articles/storage/blobs/storage-blob-download-python.md
@@ -27,9 +27,7 @@ To work with the code examples in this article, make sure you have:
     - [Get Blob](/rest/api/storageservices/get-blob#authorization)
 - The package **azure-storage-blob** installed to your project directory. To learn more about setting up your project, see [Get Started with Azure Storage and Java](storage-blob-java-get-started.md#set-up-your-project).
 
-## About downloading blobs
-
-The [Get Blob](/rest/api/storageservices/put-blob) operation reads or downloads a blob from Azure Storage, including its metadata and properties. To learn more about the `Get Blob` operation, including timeout parameters and error conditions, see [Get Blob remarks](/rest/api/storageservices/get-blob#remarks).
+[!INCLUDE [storage-dev-guide-about-blob-download](../../../includes/storage-dev-guides/storage-dev-guide-about-blob-download.md)]
 
 ## Download a blob
 
diff --git a/articles/storage/blobs/storage-blob-download-typescript.md b/articles/storage/blobs/storage-blob-download-typescript.md
@@ -27,9 +27,7 @@ To work with the code examples in this article, make sure you have:
     - [Get Blob](/rest/api/storageservices/get-blob#authorization)
 - The package **@azure/storage-blob** installed to your project directory. To learn more about setting up your project, see [Get started with Azure Blob Storage and TypeScript](storage-blob-typescript-get-started.md).
 
-## About downloading blobs
-
-The [Get Blob](/rest/api/storageservices/put-blob) operation reads or downloads a blob from Azure Storage, including its metadata and properties. To learn more about the `Get Blob` operation, including timeout parameters and error conditions, see [Get Blob remarks](/rest/api/storageservices/get-blob#remarks).
+[!INCLUDE [storage-dev-guide-about-blob-download](../../../includes/storage-dev-guides/storage-dev-guide-about-blob-download.md)]
 
 ## Download a blob
 
diff --git a/articles/storage/blobs/storage-blob-download.md b/articles/storage/blobs/storage-blob-download.md
@@ -27,9 +27,7 @@ To work with the code examples in this article, make sure you have:
     - [Get Blob](/rest/api/storageservices/get-blob#authorization)
 - The package **Azure.Storage.Blobs** installed to your project directory. To learn more about setting up your project, see [Get Started with Azure Storage and .NET](storage-blob-dotnet-get-started.md#set-up-your-project).
 
-## About downloading blobs
-
-The [Get Blob](/rest/api/storageservices/put-blob) operation reads or downloads a blob from Azure Storage, including its metadata and properties. To learn more about the `Get Blob` operation, including timeout parameters and error conditions, see [Get Blob remarks](/rest/api/storageservices/get-blob#remarks).
+[!INCLUDE [storage-dev-guide-about-blob-download](../../../includes/storage-dev-guides/storage-dev-guide-about-blob-download.md)]
 
 ## Download a blob
 
diff --git a/articles/storage/blobs/storage-blob-upload-java.md b/articles/storage/blobs/storage-blob-upload-java.md
@@ -28,11 +28,7 @@ To work with the code examples in this article, make sure you have:
     - [Put Block](/rest/api/storageservices/put-block#authorization)
 - The package **azure-storage-blob** installed to your project directory. To learn more about setting up your project, see [Get Started with Azure Storage and Java](storage-blob-java-get-started.md#set-up-your-project).
 
-## About uploading blobs
-
-The [Put Blob](/rest/api/storageservices/put-blob) operation creates a new block blob, page blob, or append blob, or updates the content of an existing block blob. If you're updating an existing block blob, any existing metadata on the blob is overwritten. To learn more about the `Put Blob` operation, including blob size limitations for write operations, see [Put Blob remarks](/rest/api/storageservices/put-blob#remarks).
-
-The [Put Block](/rest/api/storageservices/put-block) operation creates a new block to be committed as part of a blob.
+[!INCLUDE [storage-dev-guide-about-blob-upload](../../../includes/storage-dev-guides/storage-dev-guide-about-blob-upload.md)]
 
 ## Upload data to a block blob
 
diff --git a/articles/storage/blobs/storage-blob-upload-javascript.md b/articles/storage/blobs/storage-blob-upload-javascript.md
@@ -27,11 +27,7 @@ To work with the code examples in this article, make sure you have:
     - [Put Block](/rest/api/storageservices/put-block#authorization)
 - The package **@azure/storage-blob** installed to your project directory. To learn more about setting up your project, see [Get Started with Azure Storage and JavaScript](storage-blob-javascript-get-started.md#set-up-your-project).
 
-## About uploading blobs
-
-The [Put Blob](/rest/api/storageservices/put-blob) operation creates a new block blob, page blob, or append blob, or updates the content of an existing block blob. If you're updating an existing block blob, any existing metadata on the blob is overwritten. To learn more about the `Put Blob` operation, including blob size limitations for write operations, see [Put Blob remarks](/rest/api/storageservices/put-blob#remarks).
-
-The [Put Block](/rest/api/storageservices/put-block) operation creates a new block to be committed as part of a blob.
+[!INCLUDE [storage-dev-guide-about-blob-upload](../../../includes/storage-dev-guides/storage-dev-guide-about-blob-upload.md)]
 
 ## Upload data to a block blob
 
diff --git a/articles/storage/blobs/storage-blob-upload-python.md b/articles/storage/blobs/storage-blob-upload-python.md
@@ -28,11 +28,7 @@ To work with the code examples in this article, make sure you have:
     - [Put Block](/rest/api/storageservices/put-block#authorization)
 - The package **azure-storage-blob** installed to your project directory. To learn more about setting up your project, see [Get Started with Azure Storage and Python](storage-blob-python-get-started.md#set-up-your-project).
 
-## About uploading blobs
-
-The [Put Blob](/rest/api/storageservices/put-blob) operation creates a new block blob, page blob, or append blob, or updates the content of an existing block blob. If you're updating an existing block blob, any existing metadata on the blob is overwritten. To learn more about the `Put Blob` operation, including blob size limitations for write operations, see [Put Blob remarks](/rest/api/storageservices/put-blob#remarks).
-
-The [Put Block](/rest/api/storageservices/put-block) operation creates a new block to be committed as part of a blob.
+[!INCLUDE [storage-dev-guide-about-blob-upload](../../../includes/storage-dev-guides/storage-dev-guide-about-blob-upload.md)]
 
 ## Upload data to a block blob
 
diff --git a/articles/storage/blobs/storage-blob-upload-typescript.md b/articles/storage/blobs/storage-blob-upload-typescript.md
@@ -29,9 +29,7 @@ To work with the code examples in this article, make sure you have:
 
 ## About uploading blobs
 
-The [Put Blob](/rest/api/storageservices/put-blob) operation creates a new block blob, page blob, or append blob, or updates the content of an existing block blob. If you're updating an existing block blob, any existing metadata on the blob is overwritten. To learn more about the `Put Blob` operation, including blob size limitations for write operations, see [Put Blob remarks](/rest/api/storageservices/put-blob#remarks).
-
-The [Put Block](/rest/api/storageservices/put-block) operation creates a new block to be committed as part of a blob.
+[!INCLUDE [storage-dev-guide-about-blob-upload](../../../includes/storage-dev-guides/storage-dev-guide-about-blob-upload.md)]
 
 ## Upload data to a block blob
 
diff --git a/articles/storage/blobs/storage-blob-upload.md b/articles/storage/blobs/storage-blob-upload.md
@@ -27,11 +27,7 @@ To work with the code examples in this article, make sure you have:
     - [Put Block](/rest/api/storageservices/put-block#authorization)
 - The package **Azure.Storage.Blobs** installed to your project directory. To learn more about setting up your project, see [Get Started with Azure Storage and .NET](storage-blob-dotnet-get-started.md#set-up-your-project).
 
-## About uploading blobs
-
-The [Put Blob](/rest/api/storageservices/put-blob) operation creates a new block blob, page blob, or append blob, or updates the content of an existing block blob. If you're updating an existing block blob, any existing metadata on the blob is overwritten. To learn more about the `Put Blob` operation, including blob size limitations for write operations, see [Put Blob remarks](/rest/api/storageservices/put-blob#remarks).
-
-The [Put Block](/rest/api/storageservices/put-block) operation creates a new block to be committed as part of a blob.
+[!INCLUDE [storage-dev-guide-about-blob-upload](../../../includes/storage-dev-guides/storage-dev-guide-about-blob-upload.md)]
 
 ## Upload data to a block blob
 
diff --git a/includes/storage-dev-guides/storage-dev-guide-about-blob-download.md b/includes/storage-dev-guides/storage-dev-guide-about-blob-download.md
@@ -0,0 +1,15 @@
+---
+title: "include file"
+description: "include file"
+services: storage
+author: pauljewellmsft
+ms.service: storage
+ms.topic: include
+ms.date: 04/21/2023
+ms.author: pauljewell
+ms.custom: include file
+---
+
+## About downloading blobs
+
+The client library methods covered in this article wrap the [Get Blob](/rest/api/storageservices/put-blob) operation. This operation reads or downloads a blob from Azure Storage, including its metadata and properties. To learn more about the `Get Blob` operation, including timeout parameters and error conditions, see [Get Blob remarks](/rest/api/storageservices/get-blob#remarks).
diff --git a/includes/storage-dev-guides/storage-dev-guide-about-blob-upload.md b/includes/storage-dev-guides/storage-dev-guide-about-blob-upload.md
@@ -0,0 +1,17 @@
+---
+title: "include file"
+description: "include file"
+services: storage
+author: pauljewellmsft
+ms.service: storage
+ms.topic: include
+ms.date: 04/21/2023
+ms.author: pauljewell
+ms.custom: include file
+---
+
+## About uploading blobs
+
+The client library methods covered in this article wrap the [Put Blob](/rest/api/storageservices/put-blob) operation. This operation creates a new block blob, page blob, or append blob, or updates the content of an existing block blob. If you're updating an existing block blob, any existing metadata on the blob is overwritten. To learn more about the `Put Blob` operation, including blob size limitations for write operations, see [Put Blob remarks](/rest/api/storageservices/put-blob#remarks).
+
+Staging individual blocks of data uses the [Put Block](/rest/api/storageservices/put-block) operation. This operation creates a new block to be committed as part of a blob.
