Merge pull request #58073 from tamram/tamram-1112

update TOC, quickstart pre-reqs

Author: Ja-Dunn

articles/storage/blobs/TOC.yml

@@ -10,35 +10,34 @@
   items:
   - name: Create a storage account
     href: ../common/storage-quickstart-create-account.md?toc=%2fazure%2fstorage%2fblobs%2ftoc.json
-  - name: Work with blobs - Azure portal
-    href: storage-quickstart-blobs-portal.md
-  - name: Work with blobs - Storage Explorer
-    href: storage-quickstart-blobs-storage-explorer.md
-  - name: Work with blobs - PowerShell
-    href: storage-quickstart-blobs-powershell.md
-  - name: Work with blobs - CLI
-    href: storage-quickstart-blobs-cli.md
-  - name: Work with blobs - .NET 
-    href: storage-quickstart-blobs-dotnet.md
-  - name: Work with blobs - Java (Storage SDK V10) 
-    href: storage-quickstart-blobs-java-v10.md 
-  - name: Work with blobs - Java (Storage SDK V7) 
-    href: storage-quickstart-blobs-java.md
-  - name: Work with blobs - Python 
-    href: storage-quickstart-blobs-python.md
-  - name: Work with blobs - Go 
-    href: storage-quickstart-blobs-go.md
-  - name: Work with blobs - Ruby 
-    href: storage-quickstart-blobs-ruby.md
-  - name: Work with blobs - Node.js (Storage SDK v10)
-    href: storage-quickstart-blobs-nodejs-v10.md
-  - name: Work with blobs - Node.js (Storage SDK v2)
-    href: storage-quickstart-blobs-nodejs.md
-  - name: Work with blobs - JS/HTML
-    href: storage-quickstart-blobs-javascript-client-libraries.md
-
-  - name: Work with blobs - PHP
-    href: storage-quickstart-blobs-php.md
+  - name: Manage blobs without code
+    items:    
+    - name: Azure portal
+      href: storage-quickstart-blobs-portal.md
+    - name: Storage Explorer
+      href: storage-quickstart-blobs-storage-explorer.md
+    - name: PowerShell
+      href: storage-quickstart-blobs-powershell.md
+    - name: CLI
+      href: storage-quickstart-blobs-cli.md
+  - name: Develop with blobs
+    items:    
+    - name: .NET 
+      href: storage-quickstart-blobs-dotnet.md
+    - name: Java (Storage SDK V10) 
+      href: storage-quickstart-blobs-java-v10.md 
+    - name: Python 
+      href: storage-quickstart-blobs-python.md
+    - name: Go 
+      href: storage-quickstart-blobs-go.md
+    - name: Ruby 
+      href: storage-quickstart-blobs-ruby.md
+    - name: Node.js (Storage SDK v10)
+      href: storage-quickstart-blobs-nodejs-v10.md
+    - name: JS/HTML
+      href: storage-quickstart-blobs-javascript-client-libraries.md
+    - name: PHP
+      href: storage-quickstart-blobs-php.md
 - name: Tutorials
   items:
   - name: Upload and process an image
@@ -296,7 +295,7 @@
         href: ../common/storage-import-export-file-format-log.md
 - name: How to
   items:
-  - name: Develop
+  - name: Develop with blobs
     items:
     - name: REST
       href: ../common/storage-rest-api-auth.md?toc=%2fazure%2fstorage%2fblobs%2ftoc.json
@@ -306,6 +305,12 @@
       href: storage-ios-how-to-use-blob-storage.md
     - name: Xamarin
       href: storage-xamarin-blob-storage.md
+    - name: Legacy SDKs
+      items:
+      - name: Java (Storage SDK V7) 
+        href: storage-quickstart-blobs-java.md
+      - name: Node.js (Storage SDK v2)
+        href: storage-quickstart-blobs-nodejs.md
   - name: Manage
     items:
     - name: PowerShell for Azure Storage

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

@@ -4,19 +4,20 @@ description: In this quickstart, you use the Azure CLI  in object (Blob) storage
 services: storage
 author: roygara
 
-
 ms.custom: mvc
 ms.service: storage
 ms.topic: quickstart
-ms.date: 04/09/2018
+ms.date: 11/14/2018
 ms.author: rogarana
 ---
 
 # Quickstart: Upload, download, and list blobs using the Azure CLI
 
 The Azure CLI is Azure's command-line experience for managing Azure resources. You can use it in your browser with Azure Cloud Shell. You can also install it on macOS, Linux, or Windows and run it from the command line. In this quickstart, you learn to use the Azure CLI to upload and download data to and from Azure Blob storage.
 
-If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
+## Prerequisites
+
+[!INCLUDE [storage-quickstart-prereq-include](../../../includes/storage-quickstart-prereq-include.md)]
 
 [!INCLUDE [cloud-shell-try-it.md](../../../includes/cloud-shell-try-it.md)]
 

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

@@ -7,7 +7,7 @@ author: tamram
 ms.custom: mvc
 ms.service: storage
 ms.topic: quickstart
-ms.date: 08/27/2018
+ms.date: 11/14/2018
 ms.author: tamram
 ---
 
@@ -17,9 +17,7 @@ In this quickstart, you learn how to use the Azure Storage client library for .N
 
 ## Prerequisites
 
-If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
-
-To complete this quickstart, first create an Azure storage account in the [Azure portal](https://portal.azure.com/#create/Microsoft.StorageAccount-ARM). For help creating the account, see [Create a storage account](../common/storage-quickstart-create-account.md).
+[!INCLUDE [storage-quickstart-prereq-include](../../../includes/storage-quickstart-prereq-include.md)]
 
 Next, download and install .NET Core 2.0 for your operating system. If you are running Windows, you can install Visual Studio and use the .NET Framework if you prefer. You can also choose to install an editor to use with your operating system.
 

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

@@ -3,12 +3,11 @@ title: Azure Quickstart - Create a blob in object storage using Go | Microsoft D
 description: In this quickstart, you create a storage account and a container in object (Blob) storage. Then you use the storage client library for Go to upload a blob to Azure Storage, download a blob, and list the blobs in a container.
 services: storage  
 author: seguler
- 
 
 ms.custom: mvc
 ms.service: storage
 ms.topic: quickstart
-ms.date: 10/23/2018
+ms.date: 11/14/2018
 ms.author: seguler
 ---
 
@@ -18,17 +17,20 @@ In this quickstart, you learn how to use the Go programming language to upload,
 
 ## Prerequisites
 
-To complete this quickstart: 
-* Install [Go 1.8 or above](https://golang.org/dl/)
-* Download and install [Azure Storage Blob SDK for Go](https://github.com/azure/azure-storage-blob-go/) using `go get -u github.com/Azure/azure-storage-blob-go/azblob`. 
-
-> [!NOTE]
-> Make sure that you capitalize Azure in the URL. Doing otherwise can cause case-related import problems when working with the SDK. You also need to capitalize Azure in your import statements.
+[!INCLUDE [storage-quickstart-prereq-include](../../../includes/storage-quickstart-prereq-include.md)]
 
-If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
+Make sure you have the following additional prerequisites installed:
+ 
+* [Go 1.8 or above](https://golang.org/dl/)
+* [Azure Storage Blob SDK for Go](https://github.com/azure/azure-storage-blob-go/), using the following command:
 
-[!INCLUDE [storage-create-account-portal-include](../../../includes/storage-create-account-portal-include.md)]
+    ```
+    go get -u github.com/Azure/azure-storage-blob-go/azblob
+    ``` 
 
+    > [!NOTE]
+    > Make sure that you capitalize `Azure` in the URL to avoid case-related import problems when working with the SDK. Also capitalize `Azure` in your import statements.
+    
 ## Download the sample application
 The [sample application](https://github.com/Azure-Samples/storage-blobs-go-quickstart.git) used in this quickstart is a basic Go application.  
 

articles/storage/blobs/storage-quickstart-blobs-java-v10.md

@@ -4,11 +4,10 @@ description: In this quickstart, you create a container in object (Azure Blob) s
 services: storage
 author: roygara
 
-
 ms.custom: mvc
 ms.service: storage
 ms.topic: quickstart
-ms.date: 10/19/2018
+ms.date: 11/14/2018
 ms.author: rogarana
 ---
 
@@ -18,14 +17,12 @@ In this quickstart, you learn how to use the new Java Storage SDK to upload, dow
 
 ## Prerequisites
 
-Install and configure these applications:
-
-* [Maven](http://maven.apache.org/download.cgi) to work from the command line, or any Java integrated development environment that you prefer
-* [JDK](https://aka.ms/azure-jdks)
+[!INCLUDE [storage-quickstart-prereq-include](../../../includes/storage-quickstart-prereq-include.md)]
 
-If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
+Make sure you have the following additional prerequisites installed:
 
-[!INCLUDE [storage-create-account-portal-include](../../../includes/storage-create-account-portal-include.md)]
+* [Maven](http://maven.apache.org/download.cgi) to work from the command line, or any Java integrated development environment that you prefer.
+* [JDK](https://aka.ms/azure-jdks)
 
 ## Download the sample application
 

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

@@ -1,38 +1,37 @@
 ---
-title: Azure Quickstart - Create a blob in object storage using the Java Storage SDK V7 | Microsoft Docs
-description: In this quickstart, you create a storage account and a container in object (Blob) storage. Then you use the storage client library for Java to upload a blob to Azure Storage, download a blob, and list the blobs in a container.
+title: How to create a blob in Azure Storage using the Java Storage SDK v7 | Microsoft Docs
+description: Create a storage account and a container in object (Blob) storage. Then use the Azure Storage client library for Java v7 to upload a blob to Azure Storage, download a blob, and list the blobs in a container.
 services: storage
 author: roygara
 
-
 ms.custom: mvc
 ms.service: storage
-ms.topic: quickstart
-ms.date: 10/23/2018
+ms.topic: conceptual
+ms.date: 11/14/2018
 ms.author: rogarana
 ---
 
-# Quickstart: Upload, download, and list blobs using Java SDK V7
+# How to upload, download, and list blobs using Java SDK v7
 
-In this quickstart, you learn how to use Java to upload, download, and list block blobs in a container in Azure Blob storage.
+In this how-to guide, you learn how to use Java to upload, download, and list block blobs in a container in Azure Blob storage.
 
 ## Prerequisites
 
-To complete this quickstart:
+If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
 
-* Install an IDE that has Maven integration.
+Also create an Azure storage account in the [Azure portal](https://portal.azure.com/#create/Microsoft.StorageAccount-ARM). For help creating the account, see [Create a storage account](../common/storage-quickstart-create-account.md).
 
-* Alternatively, install and configure Maven to work from the command line.
+Make sure you have the following prerequisites:
 
-This tutorial uses [Eclipse](http://www.eclipse.org/downloads/) with the "Eclipse IDE for Java Developers" configuration.
+* Install an IDE that has Maven integration.
 
-If you don't have an Azure subscription, create a [free account](https://azure.microsoft.com/free/?WT.mc_id=A261C142F) before you begin.
+* Alternatively, install and configure Maven to work from the command line.
 
-[!INCLUDE [storage-create-account-portal-include](../../../includes/storage-create-account-portal-include.md)]
+This guide uses [Eclipse](http://www.eclipse.org/downloads/) with the "Eclipse IDE for Java Developers" configuration.
 
 ## Download the sample application
 
-The [sample application](https://github.com/Azure-Samples/storage-blobs-java-quickstart) used in this quickstart is a basic console application.  
+The [sample application](https://github.com/Azure-Samples/storage-blobs-java-quickstart) is a basic console application.  
 
 Use [git](https://git-scm.com/) to download a copy of the application to your development environment. 
 
@@ -127,9 +126,7 @@ container.createIfNotExists(BlobContainerPublicAccessType.CONTAINER, new BlobReq
 
 ### Upload blobs to the container
 
-Blob storage supports block blobs, append blobs, and page blobs. Block blobs are the most commonly used, and that's what is used in this quickstart. 
-
-To upload a file to a blob, get a reference to the blob in the target container. Once you have the blob reference, you can upload data to it by using [Cloud​Block​Blob.​Upload​](https://docs.microsoft.com/java/api/com.microsoft.azure.storage.blob._cloud_block_blob.upload#com_microsoft_azure_storage_blob__cloud_block_blob_upload_final_InputStream_final_long). This operation creates the blob if it doesn't already exist, or overwrites the blob if it already exists.
+To upload a file to a block blob, get a reference to the blob in the target container. Once you have the blob reference, you can upload data to it by using [Cloud​Block​Blob.​Upload​](https://docs.microsoft.com/java/api/com.microsoft.azure.storage.blob._cloud_block_blob.upload#com_microsoft_azure_storage_blob__cloud_block_blob_upload_final_InputStream_final_long). This operation creates the blob if it doesn't already exist, or overwrites the blob if it already exists.
 
 The sample code creates a local file to be used for the upload and download, storing the file to be uploaded as **source** and the name of the blob in **blob**. The following example uploads the file to your container called **quickstartcontainer**.
 
@@ -181,7 +178,7 @@ blob.downloadToFile(downloadedFile.getAbsolutePath());
 
 ### Clean up resources
 
-If you no longer need the blobs uploaded in this quickstart, you can delete the entire container using [Cloud​Blob​Container.​DeleteIfExists](https://docs.microsoft.com/java/api/com.microsoft.azure.storage.blob._cloud_blob_container.deleteifexists#com_microsoft_azure_storage_blob__cloud_blob_container_deleteIfExists). This method also deletes the files in the container.
+If you no longer need the blobs that you have uploaded, you can delete the entire container using [Cloud​Blob​Container.​DeleteIfExists](https://docs.microsoft.com/java/api/com.microsoft.azure.storage.blob._cloud_blob_container.deleteifexists#com_microsoft_azure_storage_blob__cloud_blob_container_deleteIfExists). This method also deletes the files in the container.
 
 ```java
 try {
@@ -202,7 +199,7 @@ sourceFile.deleteOnExit();
 
 ## Next steps
 
-In this quickstart, you learned how to transfer files between a local disk and Azure Blob storage using Java. To learn more about working with Java, continue to our GitHub source code repository.
+In this article, you learned how to transfer files between a local disk and Azure Blob storage using Java. To learn more about working with Java, continue to our GitHub source code repository.
 
 > [!div class="nextstepaction"]
 > [Azure Storage SDK for Java](https://github.com/azure/azure-storage-java) 

articles/storage/blobs/storage-quickstart-blobs-javascript-client-libraries.md

@@ -8,17 +8,20 @@ author: tamram
 ms.custom: mvc
 ms.service: storage
 ms.author: tamram
-ms.date: 10/18/2018
+ms.date: 11/14/2018
 ms.topic: quickstart
 ms.component: blobs
 ---
 
 <!-- Customer intent: As a web application developer I want to interface with Azure Blob storage entirely on the client so that I can build a SPA application that is able to upload and delete files on blob storage. -->
 
 # Quickstart: Upload, list, and delete blobs using JavaScript/HTML in the Browser
+
 This quickstart demonstrates how to manage blobs from code running entirely in the browser. The approach used here shows how to use required security measures to ensure protected access to your blob storage account. To complete this quickstart, you need an [Azure subscription](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
 
-[!INCLUDE [storage-create-account-portal-include](../../../includes/storage-create-account-portal-include.md)]
+## Prerequisites
+
+[!INCLUDE [storage-quickstart-prereq-include](../../../includes/storage-quickstart-prereq-include.md)]
 
 ## Setting up storage account CORS rules 
 Before your web application can access a blob storage from the client, the account must be configured to enable [cross-origin resource sharing](https://docs.microsoft.com/rest/api/storageservices/cross-origin-resource-sharing--cors--support-for-the-azure-storage-services), or CORS. 

articles/storage/blobs/storage-quickstart-blobs-nodejs-v10.md

@@ -3,20 +3,21 @@ title: Upload, download, list, and delete blobs using Azure Storage v10 SDK for
 description: Create, upload, and delete blobs and containers in Node.js with Azure Storage
 services: storage
 author: tamram
+
 ms.custom: mvc
 ms.service: storage
 ms.topic: quickstart
-ms.date: 09/19/2018
+ms.date: 11/14/2018
 ms.author: tamram
 ---
 
 # Quickstart: Upload, download, list, and delete blobs using Azure Storage v10 SDK for JavaScript (preview)
 
 In this quickstart, you learn to use the [Azure Storage v10 SDK for JavaScript](https://github.com/Azure/azure-storage-js) in Node.js to upload, download, list, and delete blobs and manage containers.
 
-To complete this quickstart, you need an [Azure subscription](https://azure.microsoft.com/free/?WT.mc_id=A261C142F).
+## Prerequisites
 
-[!INCLUDE [storage-create-account-portal-include](../../../includes/storage-create-account-portal-include.md)]
+[!INCLUDE [storage-quickstart-prereq-include](../../../includes/storage-quickstart-prereq-include.md)]
 
 ## Download the sample application