Azure SQL migration extension fixes, and move auto-update-extension.md include file

Author: rwestMSFT

docs/azure-data-studio/extensions/add-extensions.md

@@ -1,10 +1,10 @@
 ---
 title: Add extensions
 description: Learn how to add functionality to Azure Data Studio by selecting and installing extensions from among those provided by Microsoft and third parties.
-author: "markingmyname"
-ms.author: "maghan"
-ms.reviewer: erinstellato
-ms.date: "10/03/2019"
+author: markingmyname
+ms.author: maghan
+ms.reviewer: erinstellato, randolphwest
+ms.date: 12/16/2022
 ms.service: azure-data-studio
 ms.topic: conceptual
 ---
@@ -19,17 +19,17 @@ Extensions are provided by the Azure Data Studio team (Microsoft), as well as th
 
 1. Access the available extensions by selecting the Extensions Icon, or by selecting **Extensions** in the **View** menu. You can use the **View: Show Extensions** command, available in the **Command Palette** (F1 or `Ctrl+Shift+P`).
 
-    ![extension manager icon](media/add-extensions/extension-manager-icon.png)
+    :::image type="content" source="media/add-extensions/extension-manager-icon.png" alt-text="Screenshot showing the Extension manager icon.":::
 
     You can also quickly access the extensions manager by pressing `Ctrl+Shift+X` (Windows/Linux) or `Command+Shift+X` (Mac).
 
-2. Select an available extension to view its details.
+1. Select an available extension to view its details.
 
-    ![extension details](media/add-extensions/extension-details.png)
+    :::image type="content" source="media/add-extensions/extension-details.png" alt-text="Screenshot showing the Extension details.":::
 
-3. Select the extension you want and **Install** it.
+1. Select the extension you want and **Install** it.
 
-4. Once installed, **Reload** to enable the extension in Azure Data Studio (only required when installing an extension for the first time).
+1. Once installed, **Reload** to enable the extension in Azure Data Studio (only required when installing an extension for the first time).
 
 If you're having problems accessing the Extensions Manager on Azure Data Studio, you can download the extension you need on our [GitHub Wiki](https://github.com/microsoft/azuredatastudio/wiki/List-of-Extensions).
 
@@ -41,9 +41,9 @@ The default Extensions view shows the extensions that are currently enabled, all
 
 ### Uninstall an extension
 
-To uninstall an extension, click the gear icon on the right of an extension entry and choose **Uninstall** from the drop-down menu. This uninstalls the selected extension and will prompt you to reload Azure Data Studio.
+To uninstall an extension, select the gear icon on the right of an extension entry and choose **Uninstall** from the drop-down menu. This uninstalls the selected extension and will prompt you to reload Azure Data Studio.
 
- ![extension dropdown](media/add-extensions/extension-gear-dropdown.png)
+ :::image type="content" source="media/add-extensions/extension-gear-dropdown.png" alt-text="Screenshot showing the Extension dropdown.":::
 
 ### Disable an extension
 
@@ -53,13 +53,13 @@ You may temporarily disable an extension instead of permanently removing an exte
 
 If an extension has been disabled, it will be in the **Disabled** section of the extension list and marked as ***Disabled***. You can re-enable it with the **Enable** or **Enable (Workspace)** commands in the drop-down menu. The **Command Palette** also lets you enable all extensions with the commands **Extensions: Enable All Extensions** and **Extensions: Enable All Extensions (Workspace)**.
 
-![extension enabling](media/add-extensions/extensions-enable.png)
+:::image type="content" source="media/add-extensions/extensions-enable.png" alt-text="Screenshot showing how to enable extensions.":::
 
-### Updating an extension
+### <a id="updating-an-extension"></a> Update an extension
 
-Azure Data Studio automatically checks for and installs updates for any of your installed extensions. 
+Azure Data Studio automatically checks for and installs updates for any of your installed extensions.
 
-[!INCLUDE [auto-update-extension](../../includes/auto-update-extension.md)]
+[!INCLUDE [auto-update-extension](includes/auto-update-extension.md)]
 
 ## Install from a VSIX
 
@@ -75,25 +75,25 @@ The Extensions view search box supports filters to help you find and manage exte
 
 You can see a complete listing of all filters and sort commands by typing @ in the extensions search box and navigating through the suggestions:
 
-![extension sort](media/add-extensions/extension-sort.png)
+:::image type="content" source="media/add-extensions/extension-sort.png" alt-text="Screenshot showing how to sort the extensions.":::
 
 Here are the Extensions view filters:
 
-- `@builtin` - Show extensions that come with Azure Data Studio. Grouped by type (Programming Languages, Themes, etc.).
+- `@builtin` - Show extensions that come with Azure Data Studio. Grouped by type (Programming Languages, Themes, and so on.).
 - `@disabled` - Show disabled installed extensions.
 - `@enabled` - Show enabled installed extensions. Extensions can be individually enabled/disabled.
 - `@installed` - Show installed extensions.
 - `@outdated` - Show outdated installed extensions. A newer version is available on the Marketplace.
 - `@recommended` - Show recommended extensions. Grouped as Workspace specific or general use.
-- `@category` - Show extensions belonging to specified category. Below are a few of supported categories. For a complete list, type @category and follow the options in the suggestion list:
-    - `@category:themes`
-    - `@category:formatters`
-    - `@category:snippets`
+- `@category` - Show extensions belonging to specified category. Here is a short list of supported categories. For a complete list, type @category and follow the options in the suggestion list:
+  - `@category:themes`
+  - `@category:formatters`
+  - `@category:snippets`
 These filters can be combined as well. For example, `@installed @category:themes` displays all installed themes.
 
 If no filter is provided, the Extensions view displays currently installed and recommended extensions.
 
-### Sorting
+### Sort
 
 You can sort extensions with the `@sort` filter, which can take the following values:
 

docs/azure-data-studio/extensions/azure-sql-migration-extension.md

@@ -3,10 +3,9 @@ title: Azure SQL migration extension for Azure Data Studio
 description: This article describes how you can migrate your data using the Azure SQL migration extension with Azure Data Studio.
 author: croblesm
 ms.author: roblescarlos
-ms.reviewer:
-ms.date: 09/01/2021
+ms.reviewer: randolphwest
+ms.date: 12/16/2022
 ms.service: azure-data-studio
-ms.workload: data-services
 ms.topic: conceptual
 ---
 
@@ -30,27 +29,27 @@ Follow the steps below to install the Azure SQL migration extension in Azure Dat
 
 1. Open the extensions manager in Azure Data Studio. You can either select the extensions icon or select **Extensions** in the View menu.
 
-    :::image type="content" source="media/azure-sql-migration-extension/extension-icon.png" alt-text="Extension icon":::
+    :::image type="content" source="media/azure-sql-migration-extension/extension-icon.png" alt-text="Screenshot showing the migration extension icon.":::
 
-2. Type in *Azure SQL Migration* in the search bar.
+1. Type in *Azure SQL Migration* in the search bar.
 
-3. Select the **Azure SQL Migration** extension and view its details.
+1. Select the **Azure SQL Migration** extension and view its details.
 
-4. Select **Install**.
+1. Select **Install**.
 
-    :::image type="content" source="media/azure-sql-migration-extension/azure-sql-migration-extension-market-place.png" alt-text="Azure SQl Migration extension from market place":::
+    :::image type="content" source="media/azure-sql-migration-extension/azure-sql-migration-extension-market-place.png" alt-text="Screenshot showing the Azure SQL Migration extension from the Azure Marketplace.":::
 
-5. You can see the Azure SQL migration extension in the extension list once installed.
+1. You can see the Azure SQL migration extension in the extension list once installed.
 
-    :::image type="content" source="media/azure-sql-migration-extension/azure-sql-migration-icon.png" alt-text="Azure SQL migration extension":::
+    :::image type="content" source="media/azure-sql-migration-extension/azure-sql-migration-icon.png" alt-text="Screenshot showing the Azure SQL migration extension":::
 
-6. You can connect to the SQL Server instance in Azure Data Studio. Right-click the instance name and select **Manage** to see the dashboard and the **Azure SQL Migration** extension landing page.
+1. You can connect to the SQL Server instance in Azure Data Studio. Right-click the instance name and select **Manage** to see the dashboard and the **Azure SQL Migration** extension landing page.
 
-    :::image type="content" source="media/azure-sql-migration-extension/azure-sql-migration-extension-landing-page.png" alt-text="Landing page":::
+    :::image type="content" source="media/azure-sql-migration-extension/azure-sql-migration-extension-landing-page.png" alt-text="Screenshot showing the extension landing page":::
 
 ### Set up auto update for the extension
 
-[!INCLUDE [auto-update-extension](../../includes/auto-update-extension.md)]
+[!INCLUDE [auto-update-extension](includes/auto-update-extension.md)]
 
 ## Features
 
@@ -66,35 +65,35 @@ The Azure SQL migration extension supports assessment and generates Azure recomm
 
 The following migration modes are supported for the corresponding Azure SQL targets.
 
-- **Online** - The source SQL Server database is available for reading and writing activity, while database backups are continuously restored on target Azure SQL. Application downtime is limited to the duration of the cutover at the end of migration. 
+- **Online** - The source SQL Server database is available for reading and writing activity, while database backups are continuously restored on target Azure SQL. Application downtime is limited to the duration of the cutover at the end of migration.
 - **Offline** - The source database can't be used for writing activity while backup files are restored on the target Azure SQL database (Preview). Application downtime persists from the start until the completion of the migration process.
 
 ### Support matrix
 
 | Azure SQL target | Migration mode |
-|-----------------|----------------|
+| --- | --- |
 Azure SQL Managed Instance| [Online](/azure/dms/tutorial-sql-server-managed-instance-online-ads) / [Offline](/azure/dms/tutorial-sql-server-managed-instance-offline-ads)
 SQL Server on Azure Virtual Machine|[Online](/azure/dms/tutorial-sql-server-to-virtual-machine-online-ads) / [Offline](/azure/dms/tutorial-sql-server-to-virtual-machine-offline-ads)
 Azure SQL Database (Preview)| [Offline](/azure/dms/tutorial-sql-server-azure-sql-database-offline-ads)
 
-> [!TIP]
+> [!TIP]  
 > For information on pre-requisites, features and migration workflow, see [Migration using Azure Data Studio](/azure/dms/migration-using-azure-data-studio)
 
 ### Get help from Microsoft support
 
 You can raise a support request to get Microsoft support assistance if you encounter issues or errors with your database migrations using the Azure SQL Migration extension.
 
-Click on the **New support request** button in the upper section of the extension. It will automatically take you to the Azure portal, where you can fill in the details and then submit a support request.
+Select the **New support request** button in the upper section of the extension. It will automatically take you to the Azure portal, where you can fill in the details and then submit a support request.
 :::image type="content" source="media/azure-sql-migration-extension/extension-support.png" alt-text="Get help from Microsoft support for the extension":::
 
 You can submit ideas/suggestions for improvement, and other feedback, including bugs, in the [Azure Community forum — Azure Database Migration Service](https://feedback.azure.com/d365community/forum/2dd7eb75-ef24-ec11-b6e6-000d3a4f0da0).
 
-> [!NOTE]
+> [!NOTE]  
 > You can also use the **Feedback** button if you have any suggestions or feedback to improve the extension.
 
 ## Next steps
 
 - [Database migrations using Azure Data Studio](/azure/dms/migration-using-azure-data-studio)
 - [Download Azure Data Studio](../download-azure-data-studio.md)
 - [Azure Data Studio release notes](../release-notes-azure-data-studio.md)
-- [Azure Data Studio extensions](add-extensions.md)
+- [Azure Data Studio extensions](add-extensions.md)

docs/includes/auto-update-extension.md …nsions/includes/auto-update-extension.mddocs/includes/auto-update-extension.md renamed to docs/azure-data-studio/extensions/includes/auto-update-extension.md docs/includes/auto-update-extension.md renamed to docs/azure-data-studio/extensions/includes/auto-update-extension.md

@@ -1,7 +1,8 @@
 ---
 author: MikeRayMSFT
 ms.author: mikeray
-ms.date: 08/30/2021
+ms.reviewer: randolphwest
+ms.date: 12/16/2022
 ms.service: sql
 ms.topic: include
 ---
@@ -10,10 +11,10 @@ You can check for updates to the extension and have them automatically updated b
 
 To enable auto updates:
 1. Select the **Settings** icon in Azure Data Studio.
-2. Select the **checkbox** under **User > Features > Extensions > Auto Check Updates**.
-3. Select the **dropdown** under **User > Features > Extensions > Auto Update** and select either **All Extensions** or **Only Enabled Extensions**.
+1. Select the **checkbox** under **User > Features > Extensions > Auto Check Updates**.
+1. Select the **dropdown** under **User > Features > Extensions > Auto Update** and select either **All Extensions** or **Only Enabled Extensions**.
 
 :::image type="content" source="media/auto-update-extension/azure-sql-migration-extension-auto-update.png" alt-text="auto update the extension":::
 
-> [!NOTE]
+> [!NOTE]  
 > If you want to update the extension manually, you can disable **Auto Update** and install the updates from the extension in the Marketplace.