update storage region selection

Author: jluk

articles/cloud-shell/media/persisting-shell-storage/advanced-storage.png

@@ -13,7 +13,7 @@ ms.workload: infrastructure-services
 ms.tgt_pltfrm: vm-linux
 ms.devlang: na
 ms.topic: article
-ms.date: 07/24/2018
+ms.date: 09/04/2018
 ms.author: juluk
 ---
 # Overview of Azure Cloud Shell
@@ -60,33 +60,11 @@ Cloud Shell is a flexible tool that can be used from:
 * [VS Code Azure Account extension](https://marketplace.visualstudio.com/items?itemName=ms-vscode.azure-account)
 
 ### Connect your Microsoft Azure Files storage
-Cloud Shell machines are temporary and require an Azure Files share to be mounted as `clouddrive` to persist your files.
+Cloud Shell machines are temporary and require a new or existing Azure Files share to be mounted as `clouddrive` to persist your files.
 
 On first launch Cloud Shell prompts to create a resource group, storage account, and Azure Files share on your behalf. This is a one-time step and will be automatically attached for all sessions. A single file share can be mapped and will be used by both Bash and PowerShell in Cloud Shell (Preview).
 
-#### Create new storage
-![](media/overview/basic-storage.png)
-
-A locally-redundant storage (LRS) account and Azure Files share can be created on your behalf. The Azure Files share will be used for both Bash and PowerShell environments if you choose to use both. Regular storage costs apply.
-
-Three resources will be created on your behalf:
-1. Resource Group named: `cloud-shell-storage-<region>`
-2. Storage Account named: `cs<uniqueGuid>`
-3. File Share named: `cs-<user>-<domain>-com-<uniqueGuid>`
-
-> [!Note]
-> Bash in Cloud Shell also creates a default 5-GB disk image to persist `$Home`. All files in your $Home directory such as SSH keys are persisted in your user disk image stored in your mounted Azure file share. Apply best practices when saving files in your $Home directory and mounted Azure file share.
-
-#### Use existing resources
-![](media/overview/advanced-storage.png)
-
-An advanced option is provided to associate existing resources to Cloud Shell.
-At the storage setup prompt, click "Show advanced settings" to show additional options.
-
-> [!Note]
-> Dropdowns are filtered for your pre-assigned Cloud Shell region and LRS/GRS/ZRS storage accounts.
-
-[Learn about Cloud Shell storage, updating Azure file shares, and uploading/downloading files.](persisting-shell-storage.md)
+Read more to learn how to mount a [new storage account/file share](media/overview/basic-storage.png) or [select an existing one](media/overview/advanced-storage.png).
 
 ## Concepts
 * Cloud Shell runs on a temporary host provided on a per-session, per-user basis

articles/cloud-shell/overview.md

@@ -13,7 +13,7 @@ ms.workload: infrastructure-services
 ms.tgt_pltfrm: vm-linux
 ms.devlang: na
 ms.topic: article
-ms.date: 06/06/2018
+ms.date: 09/04/2018
 ms.author: juluk
 ---
 
@@ -38,9 +38,7 @@ With Bash in Cloud Shell, you can run a command called `clouddrive`, which enabl
 #### Prerequisites for manual mounting
 You can update the file share that's associated with Cloud Shell by using the `clouddrive mount` command.
 
-If you mount an existing file share, the storage accounts must be:
-* Locally redundant storage or geo-redundant storage to support file shares.
-* Located in your assigned region. When you are onboarding, the region you are assigned to is listed in the resource group name `cloud-shell-storage-<region>`.
+If you mount an existing file share, the storage accounts must be located in your select Cloud Shell region. Retrieve the location by running `env` from Bash and checking the `ACC_LOCATION`.
 
 #### The `clouddrive mount` command
 

articles/cloud-shell/persisting-shell-storage.md

@@ -1,13 +1,10 @@
 # Persist files in Azure Cloud Shell
-Cloud Shell utilizes Azure File storage to persist files across sessions.
-
-## Set up a clouddrive file share
-On initial start, Cloud Shell prompts you to associate a new or existing file share to persist files across sessions.
+Cloud Shell utilizes Azure File storage to persist files across sessions. On initial start, Cloud Shell prompts you to associate a new or existing file share to persist files across sessions.
 
 > [!NOTE]
 > Bash and PowerShell share the same file share. Only one file share can be associated with automatic mounting in Cloud Shell.
 
-### Create new storage
+## Create new storage
 
 When you use basic settings and select only a subscription, Cloud Shell creates three resources on your behalf in the supported region that's nearest to you:
 * Resource group: `cloud-shell-storage-<region>`
@@ -21,26 +18,18 @@ The file share mounts as `clouddrive` in your `$Home` directory. This is a one-t
 > [!NOTE]
 > For security, each user should provision their own storage account.  For role-based access control (RBAC), users must have contributor access or above at the storage account level.
 
-In Bash, the file share also contains a 5-GB image that is created for you which automatically persists data in your `$Home` directory. 
-
-### Use existing resources
+The file share also contains a 5-GB image that is created for you which automatically persists data in your `$Home` directory. This applies for both Bash and PowerShell.
 
-By using the advanced option, you can associate existing resources. When the storage setup prompt appears, select **Show advanced settings** to view additional options. The drop-down menus are filtered for your assigned Cloud Shell region and the locally redundant storage and geo-redundant storage accounts.
+## Use existing resources
 
-File shares receive a 5-GB image created for you to persist your `$Home` directory.
+By using the advanced option, you can associate existing resources. When the storage setup prompt appears, select **Show advanced settings** to view additional options. The populated storage options filter for locally redundant storage (LRS),  geo-redundant storage (GRS), and zone-redundant storage (ZRS) accounts. Go [here to learn more](https://docs.microsoft.com/azure/storage/common/storage-redundancy#choosing-a-replication-option) about replication options for Azure Storage accounts.
 
 ![The Resource group setting](../articles/cloud-shell/media/persisting-shell-storage/advanced-storage.png)
 
-### Restrict resource creation with an Azure resource policy
-Storage accounts that you create in Cloud Shell are tagged with `ms-resource-usage:azure-cloud-shell`. If you want to disallow users from creating storage accounts in Cloud Shell, create an [Azure resource policy for tags](../articles/azure-policy/json-samples.md) that are triggered by this specific tag.
-
-## Supported storage regions
-Associated Azure storage accounts must reside in the same region as the Cloud Shell machine that you're mounting them to.
+When selecting a Cloud Shell region you must select to mount a backing storage account in that region as well.
 
-To find your assigned region you may:
-* View the note on the "Advanced storage settings" dialog
-* Refer to the name of the storage account created for you (ex: `cloud-shell-storage-westus`)
-* Run `env` and locate the variable `ACC_LOCATION`
+### Supported storage regions
+Associated Azure storage accounts must reside in the same region as the Cloud Shell machine that you're mounting them to. To find your current region you may run `env` in Bash and locate the variable `ACC_LOCATION`. File shares receive a 5-GB image created for you to persist your `$Home` directory.
 
 Cloud Shell machines exist in the following regions:
 |Area|Region|
@@ -49,3 +38,5 @@ Cloud Shell machines exist in the following regions:
 |Europe|North Europe, West Europe|
 |Asia Pacific|India Central, Southeast Asia|
 
+## Restrict resource creation with an Azure resource policy
+Storage accounts that you create in Cloud Shell are tagged with `ms-resource-usage:azure-cloud-shell`. If you want to disallow users from creating storage accounts in Cloud Shell, create an [Azure resource policy for tags](../articles/azure-policy/json-samples.md) that are triggered by this specific tag.