diff --git a/extensions/data-workspace/README.md b/extensions/data-workspace/README.md
index 79cc0d9848..b6df98db39 100644
--- a/extensions/data-workspace/README.md
+++ b/extensions/data-workspace/README.md
@@ -1,3 +1,17 @@
+# Microsoft Data Workspace for Azure Data Studio and VS Code
+
+## Overview
+
+This extension provides additional common functionality for database projects in Azure Data Studio and VS Code. It requires other extensions to contribute support for specific project types.
+
+### VS Code
+
+This extension is bundled into the `SQL Server (MSSQL)` extension for VS Code and is required by the `SQL Database Projects` extension. It will be installed automatically when those extensions are updated or installed.
+
+### Azure Data Studio
+
+This extension is built into Azure Data Studio and will show up under the list of builtin extensions.
+
 ## Code of Conduct
 
 This project has adopted the [Microsoft Open Source Code of Conduct](https://opensource.microsoft.com/codeofconduct/). For more information see the [Code of Conduct FAQ](https://opensource.microsoft.com/codeofconduct/faq/) or contact [opencode@microsoft.com](mailto:opencode@microsoft.com) with any additional questions or comments.
diff --git a/extensions/data-workspace/package.nls.json b/extensions/data-workspace/package.nls.json
index 08de2e0186..df7f18c34d 100644
--- a/extensions/data-workspace/package.nls.json
+++ b/extensions/data-workspace/package.nls.json
@@ -1,6 +1,6 @@
 {
-	"data-workspace-view-container-name": "Projects",
-	"main-view-name": "Projects",
+	"data-workspace-view-container-name": "Database Projects",
+	"main-view-name": "Database Projects",
 	"new-command": "New",
 	"refresh-workspace-command": "Refresh",
 	"close-workspace-command": "Close Workspace",
diff --git a/extensions/sql-database-projects/README.md b/extensions/sql-database-projects/README.md
index 6b6cd3d57c..7060fe6ca9 100644
--- a/extensions/sql-database-projects/README.md
+++ b/extensions/sql-database-projects/README.md
@@ -1,9 +1,17 @@
 # Microsoft SQL Server Database Projects for Azure Data Studio and VS Code
 
-Microsoft SQL Server Database Projects for Azure Data Studio and VS Code includes:
+## Overview
+
+Microsoft SQL Server Database Projects for Azure Data Studio and VS Code provides a way to design, edit, and publish schemas for SQL databases from a source controlled project.
+
+### VS Code
+
+This extension is bundled into the `SQL Server (MSSQL)` extension for VS Code and will be installed automatically when that extension is updated or installed.
+
+### Azure Data Studio
+
+This extension is provided as a separate extension in the marketplace.
 
-## Database Projects
-The Database Projects extension provides a way to design, edit, and publish schemas for SQL databases from a source controlled project.
 
 Please report issues and feature requests [here.](https://github.com/microsoft/azuredatastudio/issues)
 
@@ -11,7 +19,8 @@ Please report issues and feature requests [here.](https://github.com/microsoft/a
 
 * Create a new database project by going to the **Projects** viewlet or by searching **Projects: New** in the command palette.
 * Existing database projects can be opened by going to the **Projects** viewlet or by searching **Projects: Open Existing** in the command palette.
-* Start from an existing database by using **Create Project From Database** from the command palette or database context menu.
+* Start from an existing database by using the **Create Project from Database** from the command palette or database context menu.
+* Start from an OpenAPI/Swagger spec by using the **Generate SQL Project from OpenAPI/Swagger spec** command.
 
 ## Code of Conduct
 
diff --git a/extensions/sql-database-projects/package.json b/extensions/sql-database-projects/package.json
index db53519249..13555a0a60 100644
--- a/extensions/sql-database-projects/package.json
+++ b/extensions/sql-database-projects/package.json
@@ -1,7 +1,7 @@
 {
   "name": "sql-database-projects",
   "displayName": "SQL Database Projects",
-  "description": "Allows users to develop and publish database schemas for MSSQL Databases",
+  "description": "Enables users to develop and publish database schemas for MSSQL Databases",
   "version": "0.14.0",
   "publisher": "Microsoft",
   "preview": true,