edit of sdk-style project content

Author: MashaMSFT

docs/azure-data-studio/extensions/schema-compare-extension.md

@@ -13,50 +13,59 @@ ms.date: 5/24/2022
 
 # Schema Compare extension
 
-The Schema Compare extension provides an easy-to-use experience to compare two database definitions and apply the differences from the source to the target.  This includes active database connections, dacpac files, and [SQL projects](sql-database-project-extension.md).
+This article provides an overview of the Schema Compare extension for Azure Data Studio. The Schema Compare extension provides an easy-to-use way to compare two database definitions and apply the differences from the source to the target.  This includes active database connections, dacpac files, and [SQL projects](sql-database-project-extension.md).
 
-It can be tedious to manually manage and synchronize different database versions. The Schema Compare extension simplifies the process of comparing databases and gives you full control when synchronizing them — you can selectively filter specific differences and categories of differences before applying the changes. The Schema Compare extension is a reliable tool that saves you time and code.
+It can be tedious to manually manage and synchronize different database versions. The Schema Compare extension simplifies the process of comparing databases and gives you full control when synchronizing them - you can selectively filter specific differences and categories of differences before applying any changes. The Schema Compare extension is a reliable tool that saves you time and code.
 
-![Schema Compare: Options Dialog](media/schema-compare-extension/schema-compare-options.png)
+
+:::image type="content" source="media/schema-compare-extension/schema-compare-options.png" alt-text="Screenshot of the Azure Data Studio GUI, compare schema extension":::
 
 ## Features
 
-* Compare schemas between two dacpac files, databases, or SQL projects
-* View results as a set of actions that must be taken against the target for it to match the source
-* Selectively exclude actions listed in results
-* Set options that control the scope of the comparison
-* Apply changes to target or generate a script with the same effect
-* Save the comparison
+The Schema Compare extension provides the following features: 
+
+* Compare schemas between two dacpac files, databases, or SQL projects.
+* View results as a set of actions to take against the target for it to match the source.
+* Selectively exclude actions listed in results.
+* Set options that control the scope of the comparison.
+* Apply changes directly to the target or generate a script to apply changes at a later time. 
+* Save the comparison. 
 
-![Schema Compare: Example Comparison](media/schema-compare-extension/schema-compare.png)
+:::image type="content" source="media/schema-compare-extension/schema-compare.png" alt-text="Screenshot of the Azure Data Studio GUI, comparing schemas":::
 
 
 ## Install the extension
 
-1. Select the Extensions Icon to view the available extensions.
+To install the Schema Compare extension, follow these steps: 
+
+1. In Azure Data Studio, Select the Extensions Icon to view available extensions.
 
-    :::image type="content" source="media/schema-compare-extension/schema-compare-marketplace-search.png" alt-text="marketplace search":::
+    :::image type="content" source="media/schema-compare-extension/schema-compare-marketplace-search.png" alt-text="Screenshot of the Azure Data Studio GUI, marketplace search":::
 
 2. Search for the **Schema Compare** extension and select it to view its details. Select **Install** to add the extension.
 
 3. Once installed, **Reload** to enable the extension in Azure Data Studio (only required when installing an extension for the first time).
 
-## Launch a schema comparison
+## Compare schemas 
 
-1. To open the Schema Compare dialog, **right-click** a database in the Object Explorer and Select **Schema Compare**. The database you select is set as the Source database in the comparison.
+To compare schemas, open the Schema Compare dialog box. To do so, follow these steps: 
 
-    :::image type="content" source="media/schema-compare-extension/schema-compare-launch.png" alt-text="schema compare launch":::
+1. To open the Schema Compare dialog box, right-click a database in Object Explorer and select **Schema Compare**. The database you select is set as the **Source** database in the comparison.
 
-2. Select one of the ellipses (...) to change the Source and Target of your Schema Compare and Select OK.
+    :::image type="content" source="media/schema-compare-extension/schema-compare-launch.png" alt-text="Screenshot of the Azure Data Studio GUI, schema compare launch":::
 
-    :::image type="content" source="media/schema-compare-extension/schema-compare-select-source-target.png" alt-text="schema compare select source target":::
+2. Select one of the ellipses (...) to change the **Source** and **Target** of your Schema Compare and select OK.
 
-3. To customize your comparison, Select the **Options** button in the toolbar.
+    :::image type="content" source="media/schema-compare-extension/schema-compare-select-source-target.png" alt-text="Screenshot of the Azure Data Studio GUI, schema compare,  select source and target":::
+
+3. To customize your comparison, select the **Options** button in the toolbar.
 
 4. Select **Compare** to view the results of the comparison.
 
 ## Update an existing SQL project from a database
 
+To update an existing SQL project from a database, follow these steps: 
+
 1. Install both the **Schema Compare** and **[SQL Database Project](sql-database-project-extension.md)** extensions.
 
 2. From a **Database dashboard** select the **Update Project from Database** option in the toolbar.

docs/azure-data-studio/extensions/sql-database-project-extension-build-from-command-line.md

@@ -13,9 +13,10 @@ ms.date: 5/24/2022
 
 # Build a database project from command line
 
-While the SQL Database Project extension (preview) provides a graphical user interface to [build a database project](sql-database-project-extension-build.md), a command line build experience is also available for Windows, macOS, and Linux environments. The steps to build a project from the command line are different between [SDK-style SQL projects](sql-database-project-extension-sdk-style-projects.md) and the previous SQL project format.  This article outlines the prerequisites and syntax needed to build a SQL project to dacpac from the command line for both SQL project types.
+While the SQL Database Project extension (preview) provides a graphical user interface to [build a database project](sql-database-project-extension-build.md), a command line build experience is also available for Windows, macOS, and Linux environments. The steps to build a project from the command line are different between [SDK-style SQL projects](sql-database-project-extension-sdk-style-projects.md) and the previous non-SDK-style SQL project format.  This article outlines the prerequisites and syntax needed to build a SQL project to dacpac from the command line for both SQL project types.
 
 ## SDK-style SQL projects
+
 Using [Microsoft.Build.Sql](https://www.nuget.org/packages/Microsoft.Build.Sql) with [SDK-style SQL projects](sql-database-project-extension-sdk-style-projects.md) is the preferred method for working with SQL projects from the command line.
 
 To build an SDK-style SQL project from the command line on Windows, macOS, or Linux, use the following command:
@@ -24,6 +25,9 @@ To build an SDK-style SQL project from the command line on Windows, macOS, or Li
 dotnet build /p:NetCoreBuild=true
 ```
 
+> [!NOTE]
+> Using SDK-style SQL projects is currently in preview. 
+
 
 ## Non-SDK-style SQL projects
 

docs/azure-data-studio/extensions/sql-database-project-extension-sdk-style-projects.md

@@ -1,5 +1,5 @@
 ---
-title: Using SDK-style projects with the SQL Database Projects extension
+title: Use SDK-style projects with the SQL Database Projects extension
 description: Getting started using SDK-style SQL projects with the SQL Database Projects extension for Azure Data Studio or VS Code
 ms.prod: azure-data-studio
 ms.technology: azure-data-studio
@@ -12,21 +12,26 @@ ms.custom:
 ms.date: 5/24/2022
 ---
 
-# Using SDK-style SQL projects with the SQL Database Projects extension (Preview)
+# Use SDK-style SQL projects with the SQL Database Projects extension (Preview)
 
-This article introduces [Microsoft.Build.Sql](https://www.nuget.org/packages/Microsoft.Build.Sql) for SDK-style SQL projects in the SQL Database Projects extension in Azure Data Studio or VS Code. SDK-style SQL projects are especially advantageous for applications shipped through pipelines or built in cross-platform environments.  The initial announcement is available in [TechCommunity](https://techcommunity.microsoft.com/t5/azure-sql-blog/microsoft-build-sql-the-next-frontier-of-sql-projects/ba-p/3290628).
+This article introduces [Microsoft.Build.Sql](https://www.nuget.org/packages/Microsoft.Build.Sql) for SDK-style SQL projects  in the SQL Database Projects extension in Azure Data Studio or VS Code. SDK-style SQL projects are especially advantageous for applications shipped through pipelines or built in cross-platform environments.  The initial announcement is available in [TechCommunity](https://techcommunity.microsoft.com/t5/azure-sql-blog/microsoft-build-sql-the-next-frontier-of-sql-projects/ba-p/3290628).
+
+> [!NOTE]
+> Using SDK-style SQL projects is currently in preview. 
 
 ## Create an SDK-style database project
 
+You can create an SDK-style database project from a blank project, or from an existing database. 
+
 ### Blank project
 
-In the **Projects** view, select the **New Project** button and enter a project name in the text input that appears.  In the "Select a Folder" dialog that appears, select a directory for the project's folder, `.sqlproj` file, and other contents to reside in.  
+In the **Projects** view, select the **New Project** button and enter a project name in the text input that appears.  In the **Select a Folder** dialog box that appears, choose a directory for the project's folder, `.sqlproj` file, and other contents to reside in.  
 
 By default the selection for **SDK-style project (Preview)** is checked. When the dialog is completed, the empty project is opened and visible in the **Projects** view for editing.
 
 ### From an existing database
 
-In the **Project** view, select the **Import Project from Database** button and connect to a SQL Server.  Once the connection is established, select a database from the list available databases and set the name of the project.  Select a target structure of the extraction.  
+In the **Project** view, select the **Import Project from Database** button and connect to a SQL Server.  Once the connection is established, select a database from the list of available databases and set the name of the project.  Select a target structure of the extraction.  
 
 By default the selection for **SDK-style project (Preview)** is checked. When the dialog is completed, the new project is opened and contains SQL scripts for the contents of the selected database.