Address reviewer feedback

Author: sdwheeler

articles/cloud-shell/TOC.yml

@@ -1,56 +1,61 @@
-- name: Overview
-  href: overview.md
-- name: Quickstart
-  items:
-  - name: Bash - Quickstart
-    href: quickstart.md
-  - name: PowerShell - Quickstart
-    href: quickstart-powershell.md
-- name: Features & tools
-  href: features.md
-- name: Tutorials
-  items:
-  - name: Ansible
+items:
+  - name: Overview
+    href: overview.md
+  - name: Quickstart
     items:
-    - name: Run Ansible playbook
-      href: /azure/developer/ansible/getting-started-cloud-shell?bc=%2Fazure%2Fbread%2Ftoc.json&toc=%2Fazure%2Fcloud-shell%2Ftoc.json&tabs=azure-powershell
-    - name: Manage your Azure dynamic inventories
-      href: /azure/developer/ansible/dynamic-inventory-configure?bc=%2Fazure%2Fbread%2Ftoc.json&toc=%2Fazure%2Fcloud-shell%2Ftoc.json&tabs=azure-powershell
-  - name: Terraform
+      - name: Bash - Quickstart
+        href: quickstart.md
+      - name: PowerShell - Quickstart
+        href: quickstart-powershell.md
+  - name: Features & tools
+    href: features.md
+  - name: Tutorials
     items:
-    - name: Install and configure Terraform
-      href: /azure/developer/terraform/quickstart-configure?bc=%2fazure%2fbread%2ftoc.json&toc=%2fazure%2fcloud-shell%2ftoc.json
-- name: Concepts
-  items:
-  - name: Security
+      - name: Ansible
+        items:
+          - name: Run Ansible playbook
+            href: /azure/developer/ansible/getting-started-cloud-shell?bc=%2Fazure%2Fbread%2Ftoc.json&toc=%2Fazure%2Fcloud-shell%2Ftoc.json&tabs=azure-powershell
+          - name: Manage your Azure dynamic inventories
+            href: /azure/developer/ansible/dynamic-inventory-configure?bc=%2Fazure%2Fbread%2Ftoc.json&toc=%2Fazure%2Fcloud-shell%2Ftoc.json&tabs=azure-powershell
+      - name: Terraform
+        items:
+          - name: Install and configure Terraform
+            href: /azure/developer/terraform/quickstart-configure?bc=%2fazure%2fbread%2ftoc.json&toc=%2fazure%2fcloud-shell%2ftoc.json
+  - name: Concepts
     items:
-    - name: Security baseline
-      href: /security/benchmark/azure/baselines/cloud-shell-security-baseline?bc=%2fazure%2fbread%2ftoc.json&toc=%2fazure%2fcloud-shell%2ftoc.json
-- name: How-to guides
-  items:
-  - name: Persist files in storage
-    href: persisting-shell-storage.md
-  - name: Use the window
-    href: using-the-shell-window.md
-  - name: Use MSI in Cloud Shell
-    href: msi-authorization.md
-  - name: Embed Cloud Shell
-    href: embed-cloud-shell.md
-  - name: Cloud Shell in Azure Virtual Network
-    href: private-vnet.md
-  - name: Use the Cloud Shell editor
-    href: using-cloud-shell-editor.md
-  - name: Troubleshooting & limitations
-    href: troubleshooting.md
-- name: Reference
-  items:
-  - name: Azure CLI
-    href: /cli/azure/
-  - name: Azure PowerShell
-    href: /powershell/azure/
-- name: Resources
-  items:
-  - name: Azure Roadmap
-    href: https://azure.microsoft.com/roadmap/?category=monitoring-management
-  - name: Pricing calculator
-    href: https://azure.microsoft.com/pricing/calculator/
+      - name: Security
+        items:
+          - name: Security baseline
+            href: /security/benchmark/azure/baselines/cloud-shell-security-baseline?bc=%2fazure%2fbread%2ftoc.json&toc=%2fazure%2fcloud-shell%2ftoc.json
+  - name: How-to guides
+    items:
+      - name: Persist files in storage
+        href: persisting-shell-storage.md
+      - name: Use the window
+        href: using-the-shell-window.md
+      - name: Use MSI in Cloud Shell
+        href: msi-authorization.md
+      - name: Embed Cloud Shell
+        href: embed-cloud-shell.md
+      - name: Cloud Shell in an Azure virtual network
+        href: private-vnet.md
+      - name: Use the Cloud Shell editor
+        href: using-cloud-shell-editor.md
+      - name: Troubleshooting
+        href: troubleshooting.md
+      - name: Limitations
+        href: limitations.md
+  - name: Pricing
+    href: pricing.md
+  - name: Reference
+    items:
+      - name: Azure CLI
+        href: /cli/azure/
+      - name: Azure PowerShell
+        href: /powershell/azure/
+  - name: Resources
+    items:
+      - name: Azure Roadmap
+        href: https://azure.microsoft.com/roadmap/?category=monitoring-management
+      - name: Pricing calculator
+        href: https://azure.microsoft.com/pricing/calculator/

articles/cloud-shell/embed-cloud-shell.md

@@ -16,29 +16,34 @@ title: Embed Azure Cloud Shell
 # Embed Azure Cloud Shell
 
 Embedding Cloud Shell enables developers and content writers to directly open Cloud Shell from a
-dedicated URL, `shell.azure.com`. This immediately brings the full power of Cloud Shell's
-authentication, tooling, and up-to-date Azure CLI and Azure PowerShell tools to your users.
+dedicated URL, `shell.azure.com`. This link brings the full power of Cloud Shell's authentication,
+tooling, and up-to-date Azure CLI and Azure PowerShell tools to your users.
 
-[![Regular launch](media/embed-cloud-shell/LaunchCloudShell.png "Launch Azure Cloud Shell")][01]
+You can use the following images in your own webpages and app as buttons to start a Cloud Shell
+session.
+
+Regular sized button
+
+![Regular launch](media/embed-cloud-shell/launch-cloud-shell-1.png "Launch Azure Cloud Shell")
 
 Large sized button
 
-[![Large launch](media/embed-cloud-shell/LaunchCloudShell2x.png "Launch Azure Cloud Shell")][01]
+![Large launch](media/embed-cloud-shell/launch-cloud-shell-2.png "Launch Azure Cloud Shell")
 
 ## How-to
 
-Integrate Cloud Shell's launch button into markdown files by copying the following:
+To integrate Cloud Shell's launch button into markdown files by copying the following code:
 
 Regular sized button
 
 ```markdown
-[![Launch Cloud Shell](https://learn.microsoft.com/azure/cloud-shell/media/embed-cloudshell/launchcloudshell.png](https://shell.azure.com)
+[![Launch Cloud Shell](https://learn.microsoft.com/azure/cloud-shell/media/embed-cloud-shell/launch-cloud-shell-1.png](https://shell.azure.com)
 ```
 
 Large sized button
 
 ```markdown
-[![Launch Cloud Shell](https://learn.microsoft.com/azure/cloud-shell/media/embed-cloudshelllaunchcloudshell@2x.png](https://shell.azure.com)
+[![Launch Cloud Shell](https://learn.microsoft.com/azure/cloud-shell/media/embed-cloud-shell/launch-cloud-shell-2.png](https://shell.azure.com)
 ```
 
 The location of these image files is subject to change. We recommend that you download the files for
@@ -48,11 +53,11 @@ use in your applications.
 
 Set a specific shell experience by augmenting your URL.
 
-|        Experience        |             URL              |
-| ------------------------ | ---------------------------- |
-| Most recently used shell | `shell.azure.com`            |
-| Bash                     | `shell.azure.com/bash`       |
-| PowerShell               | `shell.azure.com/powershell` |
+|        Experience        |                 URL                  |
+| ------------------------ | ------------------------------------ |
+| Most recently used shell | `https://shell.azure.com`            |
+| Bash                     | `https://shell.azure.com/bash`       |
+| PowerShell               | `https://shell.azure.com/powershell` |
 
 ## Next steps
 

articles/cloud-shell/features.md

@@ -20,7 +20,7 @@ Azure Cloud Shell is a browser-based shell experience to manage and develop Azur
 Cloud Shell offers a browser-accessible, pre-configured shell experience for managing Azure
 resources without the overhead of installing, versioning, and maintaining a machine yourself.
 
-Cloud Shell provisions machines on a per-request basis and as a result machine state does not
+Cloud Shell allocates machines on a per-request basis and as a result machine state doesn't
 persist across sessions. Since Cloud Shell is built for interactive sessions, shells automatically
 terminate after 20 minutes of shell inactivity.
 
@@ -35,8 +35,8 @@ distribution for cloud-infrastructure-edge products and services.
 Microsoft internally compiles all the packages included in the **CBL-Mariner** repository to help
 guard against supply chain attacks. Tooling has been updated to reflect the new base image
 CBL-Mariner. You can get a full list of installed package versions using the following command:
-`tdnf list installed`. If these changes affected your Cloud Shell environment, please contact
-Azuresupport or create an issue in the [Cloud Shell repository][12].
+`tdnf list installed`. If these changes affected your Cloud Shell environment, contact Azure Support
+or create an issue in the [Cloud Shell repository][12].
 
 ## Features
 
@@ -51,8 +51,8 @@ To persist files across sessions, Cloud Shell walks you through attaching an Azu
 first launch. Once completed, Cloud Shell will automatically attach your storage (mounted as
 `$HOME\clouddrive`) for all future sessions. Additionally, your `$HOME` directory is persisted as an
 .img in your Azure File share. Files outside of `$HOME` and machine state aren't persisted across
-sessions. Use best practices when storing secrets such as SSH keys. Services like
-[Azure Key Vault have tutorials for setup][02].
+sessions. Use best practices when storing secrets such as SSH keys. Services, like
+Azure Key Vault, have [tutorials for setup][02].
 
 [Learn more about persisting files in Cloud Shell.][29]
 

articles/cloud-shell/limitations.md

@@ -46,7 +46,7 @@ Chrome, Mozilla Firefox, and Apple Safari. Safari in private mode isn't supporte
 - Windows: <kbd>Ctrl</kbd>-<kbd>C</kbd> to copy is supported but use
   <kbd>Shift</kbd>-<kbd>Insert</kbd> to paste.
   - FireFox/IE may not support clipboard permissions properly.
-- Mac OS: <kbd>Cmd</kbd>-<kbd>C</kbd> to copy and <kbd>Cmd</kbd>-<kbd>V</kbd> to paste.
+- macOS: <kbd>Cmd</kbd>-<kbd>C</kbd> to copy and <kbd>Cmd</kbd>-<kbd>V</kbd> to paste.
 
 ### Only one shell can be active for a given user
 
@@ -83,19 +83,18 @@ functionality.
 The `SqlServer` module included in Cloud Shell has only prerelease support for PowerShell Core. In
 particular, `Invoke-SqlCmd` isn't available yet.
 
-### Default file location when created from Azure drive:
+### Default file location when created from Azure drive
 
-Using PowerShell cmdlets, users can not create files under the Azure: drive. When users create new
-files using other tools, such as vim or nano, the files are saved to the `$HOME` by default.
+You can't create files under the `Azure:` drive. When users create new files using other tools, such
+as vim or nano, the files are saved to the `$HOME` by default.
 
 ### GUI applications aren't supported
 
-If the user runs a command that would create a Windows dialog box, one sees an error message such
+If the user runs a command that would create a dialog box, one sees an error message such
 as:
 
-```
-Unable to load DLL 'IEFRAME.dll': The specified module couldn't be found. (Exception from HRESULT: 0x8007007E)
-```
+> Unable to load DLL 'IEFRAME.dll': The specified module couldn't be found.
+
 
 ### Large Gap after displaying progress bar
 

…a/embed-cloud-shell/LaunchCloudShell.png …bed-cloud-shell/launch-cloud-shell-1.pngarticles/cloud-shell/media/embed-cloud-shell/LaunchCloudShell.png renamed to articles/cloud-shell/media/embed-cloud-shell/launch-cloud-shell-1.png articles/cloud-shell/media/embed-cloud-shell/LaunchCloudShell.png renamed to articles/cloud-shell/media/embed-cloud-shell/launch-cloud-shell-1.png

@@ -56,14 +56,14 @@ curl https://management.azure.com/subscriptions/{subscriptionId}/providers/Micro
 
 ## Handling token expiration
 
-The local authentication endpoint caches tokens. You can call it as often as you like, and an
-authentication call to Azure Active Directory only occurs if there's no token stored in the cache,
-or the token has expired.
+The local authentication endpoint caches tokens. You can call it as often as you like. Cloud Shell
+only calls Azure Active Directory only occurs when there's no token stored in the cache or the token
+has expired.
 
 ## Limitations
 
-- There's an allowlist of resources that Cloud Shell tokens can be provided for. You may see a
-  message similar to the following:
+- There's an allowlist of resources that Cloud Shell tokens can be provided for. When you try to use
+  a token with a service that is not listed, you may see the following error message:
 
   ```
   "error":{"code":"AudienceNotSupported","message":"Audience https://newservice.azure.com/
@@ -72,7 +72,7 @@ or the token has expired.
 
   You can open an issue on [GitHub][02] to request for the service to be added to the allowlist.
 
-- If you log in explicitly using the `az login` command, any Conditional Access rules your company
+- If you sign in explicitly using the `az login` command, any Conditional Access rules your company
   may have in place are evaluated based on the Cloud Shell container rather than the machine where
   your browser runs. The Cloud Shell container doesn't count as a managed device for these policies
   so rights may be limited by the policy.