Merge pull request #196794 from seesharprun/may2-create-cosmos-include-visual-studio-community

Add new include for VS Community edition

Author: v-regandowner

articles/cosmos-db/cassandra/manage-data-dotnet-core.md

@@ -7,7 +7,7 @@ author: TheovanKraay
 ms.author: thvankra
 ms.devlang: csharp
 ms.topic: quickstart
-ms.date: 10/01/2020
+ms.date: 05/02/2020
 ms.custom: devx-track-dotnet, mode-api
 ---
 
@@ -33,18 +33,17 @@ Azure Cosmos DB is Microsoft's globally distributed multi-model database service
 [!INCLUDE [quickstarts-free-trial-note](../../../includes/quickstarts-free-trial-note.md)] Alternatively, you can [Try Azure Cosmos DB for free](https://azure.microsoft.com/try/cosmosdb/) without an Azure subscription, free of charge and commitments.
 
 In addition, you need: 
-* If you don't already have Visual Studio 2019 installed, you can download and use the **free** [Visual Studio 2019 Community Edition](https://www.visualstudio.com/downloads/). Make sure that you enable **Azure development** during the Visual Studio setup.
+* Latest [!INCLUDE [cosmos-db-visual-studio](../includes/cosmos-db-visual-studio.md)]
 * Install [Git](https://www.git-scm.com/) to clone the example.
 
-<a id="create-account"></a>
 ## Create a database account
 
 [!INCLUDE [cosmos-db-create-dbaccount-cassandra](../includes/cosmos-db-create-dbaccount-cassandra.md)]
 
 
 ## Clone the sample application
 
-Now let's switch to working with code. Let's clone a Cassandra API app from GitHub, set the connection string, and run it. You'll see how easy it is to work with data programmatically. 
+Now let's switch to working with code. Let's clone a Cassandra API app from GitHub, set the connection string, and run it. You'll see how easily you can work with data programmatically. 
 
 1. Open a command prompt. Create a new folder named `git-samples`. Then, close the command prompt.
 
@@ -190,7 +189,7 @@ Now go back to the Azure portal to get your connection string information and co
 
 ## Next steps
 
-In this quickstart, you've learned how to create an Azure Cosmos DB account, create a container using the Data Explorer, and run a web app. You can now import additional data to your Cosmos DB account.
+In this quickstart, you've learned how to create an Azure Cosmos DB account, create a container using the Data Explorer, and run a web app. You can now import other data to your Cosmos DB account.
 
 > [!div class="nextstepaction"]
 > [Import Cassandra data into Azure Cosmos DB](migrate-data.md)

articles/cosmos-db/cassandra/manage-data-dotnet.md

@@ -7,7 +7,7 @@ author: TheovanKraay
 ms.author: thvankra
 ms.devlang: csharp
 ms.topic: quickstart
-ms.date: 10/01/2020
+ms.date: 05/02/2022
 ms.custom: devx-track-csharp, mode-api
 ---
 
@@ -33,18 +33,17 @@ Azure Cosmos DB is Microsoft's globally distributed multi-model database service
 [!INCLUDE [quickstarts-free-trial-note](../../../includes/quickstarts-free-trial-note.md)] Alternatively, you can [Try Azure Cosmos DB for free](https://azure.microsoft.com/try/cosmosdb/) without an Azure subscription, free of charge and commitments.
 
 In addition, you need: 
-* If you don't already have Visual Studio 2019 installed, you can download and use the **free** [Visual Studio 2019 Community Edition](https://www.visualstudio.com/downloads/). Make sure that you enable **Azure development** during the Visual Studio setup.
+* Latest [!INCLUDE [cosmos-db-visual-studio](../includes/cosmos-db-visual-studio.md)]
 * Install [Git](https://www.git-scm.com/) to clone the example.
 
-<a id="create-account"></a>
 ## Create a database account
 
 [!INCLUDE [cosmos-db-create-dbaccount-cassandra](../includes/cosmos-db-create-dbaccount-cassandra.md)]
 
 
 ## Clone the sample application
 
-Now let's switch to working with code. Let's clone a Cassandra API app from GitHub, set the connection string, and run it. You'll see how easy it is to work with data programmatically. 
+Now let's switch to working with code. Let's clone a Cassandra API app from GitHub, set the connection string, and run it. You'll see how easily you can work with data programmatically. 
 
 1. Open a command prompt. Create a new folder named `git-samples`. Then, close the command prompt.
 
@@ -173,7 +172,7 @@ Now go back to the Azure portal to get your connection string information and co
 
 ## Next steps
 
-In this quickstart, you've learned how to create an Azure Cosmos DB account, create a container using the Data Explorer, and run a web app. You can now import additional data to your Cosmos DB account. 
+In this quickstart, you've learned how to create an Azure Cosmos DB account, create a container using the Data Explorer, and run a web app. You can now import other data to your Cosmos DB account. 
 
 > [!div class="nextstepaction"]
 > [Import Cassandra data into Azure Cosmos DB](migrate-data.md)

articles/cosmos-db/graph/bulk-executor-graph-dotnet.md

@@ -4,7 +4,7 @@ description: Learn how to use the bulk executor library to massively import grap
 ms.service: cosmos-db
 ms.subservice: cosmosdb-graph
 ms.topic: how-to
-ms.date: 05/28/2019
+ms.date: 05/02/2020
 author: manishmsfte
 ms.author: mansha
 ms.devlang: csharp
@@ -24,7 +24,7 @@ The [bulk executor library](/dotnet/api/microsoft.azure.cosmosdb.bulkexecutor.gr
 
 The following process outlines how data migration can be used for a Gremlin API container:
 1. Retrieve records from the data source.
-2. Construct `GremlinVertex` and `GremlinEdge` objects from the obtained records and add them into an `IEnumerable` data structure. In this part of the application the logic to detect and add relationships should be implemented, in case the data source is not a graph database.
+2. Construct `GremlinVertex` and `GremlinEdge` objects from the obtained records and add them into an `IEnumerable` data structure. In this part of the application the logic to detect and add relationships should be implemented, in case the data source isn't a graph database.
 3. Use the [Graph BulkImportAsync method](/dotnet/api/microsoft.azure.cosmosdb.bulkexecutor.graph.graphbulkexecutor.bulkimportasync) to insert the graph objects into the collection.
 
 This mechanism will improve the data migration efficiency as compared to using a Gremlin client. This improvement is experienced because inserting data with Gremlin will require the application send a query at a time that will need to be validated, evaluated, and then executed to create the data. The bulk executor library will handle the validation in the application and send multiple graph objects at a time for each network request.
@@ -70,9 +70,9 @@ catch (Exception e)
 }
 ```
 
-For more information on the parameters of the bulk executor library, refer to the [BulkImportData to Azure Cosmos DB topic](../bulk-executor-dot-net.md#bulk-import-data-to-an-azure-cosmos-account).
+For more information about the parameters of the bulk executor library, see [BulkImportData to Azure Cosmos DB article](../bulk-executor-dot-net.md#bulk-import-data-to-an-azure-cosmos-account).
 
-The payload needs to be instantiated into `GremlinVertex` and `GremlinEdge` objects. Here is how these objects can be created:
+The payload needs to be instantiated into `GremlinVertex` and `GremlinEdge` objects. Here's how these objects can be created:
 
 **Vertices**:
 ```csharp
@@ -111,7 +111,7 @@ e.AddProperty("customProperty", "value");
 ## Sample application
 
 ### Prerequisites
-* Visual Studio 2019 with the Azure development workload. You can get started with the [Visual Studio 2019 Community Edition](https://visualstudio.microsoft.com/downloads/) for free.
+* Latest [!INCLUDE [cosmos-db-visual-studio](../includes/cosmos-db-visual-studio.md)]
 * An Azure subscription. You can create [a free Azure account here](https://azure.microsoft.com/free/?ref=microsoft.com&utm_source=microsoft.com&utm_medium=docs&utm_campaign=cosmos-db). Alternatively, you can create a Cosmos database account with [Try Azure Cosmos DB for free](https://azure.microsoft.com/try/cosmosdb/) without an Azure subscription.
 * An Azure Cosmos DB Gremlin API database with an **unlimited collection**. This guide shows how to get started with [Azure Cosmos DB Gremlin API in .NET](./create-graph-dotnet.md).
 * Git. For more information check out the [Git Downloads page](https://git-scm.com/downloads).
@@ -135,9 +135,9 @@ In the `App.config` file, the following are the configuration values that can be
 
 Setting|Description
 ---|---
-`EndPointUrl`|This is **your .NET SDK endpoint** found in the Overview blade of your Azure Cosmos DB Gremlin API database account. This has the format of `https://your-graph-database-account.documents.azure.com:443/`
+`EndPointUrl`|This is **your .NET SDK endpoint** found in the Overview page of your Azure Cosmos DB Gremlin API database account. This has the format of `https://your-graph-database-account.documents.azure.com:443/`
 `AuthorizationKey`|This is the Primary or Secondary key listed under your Azure Cosmos DB account. Learn more about [Securing Access to Azure Cosmos DB data](../secure-access-to-data.md#primary-keys)
-`DatabaseName`, `CollectionName`|These are the **target database and collection names**. When `ShouldCleanupOnStart` is set to `true` these values, along with `CollectionThroughput`, will be used to drop them and create a new database and collection. Similarly, if `ShouldCleanupOnFinish` is set to `true`, they will be used to delete the database as soon as the ingestion is over. Note that the target collection must be **an unlimited collection**.
+`DatabaseName`, `CollectionName`|These are the **target database and collection names**. When `ShouldCleanupOnStart` is set to `true` these values, along with `CollectionThroughput`, will be used to drop them and create a new database and collection. Similarly, if `ShouldCleanupOnFinish` is set to `true`, they'll be used to delete the database as soon as the ingestion is over. The target collection must be **an unlimited collection**.
 `CollectionThroughput`|This is used to create a new collection if the `ShouldCleanupOnStart` option is set to `true`.
 `ShouldCleanupOnStart`|This will drop the database account and collections before the program is run, and then create new ones with the `DatabaseName`, `CollectionName` and `CollectionThroughput` values.
 `ShouldCleanupOnFinish`|This will drop the database account and collections with the specified `DatabaseName` and `CollectionName` after the program is run.
@@ -147,8 +147,8 @@ Setting|Description
 
 ### Run the sample application
 
-1. Add your specific database configuration parameters in `App.config`. This will be used to create a DocumentClient instance. If the database and container have not been created yet, they will be created automatically.
-2. Run the application. This will call `BulkImportAsync` two times, one to import Vertices and one to import Edges. If any of the objects generates an error when they're inserted, they will be added to either `.\BadVertices.txt` or `.\BadEdges.txt`.
+1. Add your specific database configuration parameters in `App.config`. This will be used to create a DocumentClient instance. If the database and container haven't been created yet, they'll be created automatically.
+2. Run the application. This will call `BulkImportAsync` two times, one to import Vertices and one to import Edges. If any of the objects generates an error when they're inserted, they'll be added to either `.\BadVertices.txt` or `.\BadEdges.txt`.
 3. Evaluate the results by querying the graph database. If the `ShouldCleanupOnFinish` option is set to true, then the database will automatically be deleted.
 
 ## Next steps

articles/cosmos-db/graph/create-graph-dotnet.md

@@ -7,7 +7,7 @@ ms.service: cosmos-db
 ms.subservice: cosmosdb-graph
 ms.devlang: csharp
 ms.topic: quickstart
-ms.date: 02/21/2020
+ms.date: 05/02/2020
 ms.custom: devx-track-dotnet, mode-api
 ---
 # Quickstart: Build a .NET Framework or Core application using the Azure Cosmos DB Gremlin API account
@@ -28,7 +28,7 @@ This quickstart demonstrates how to create an Azure Cosmos DB [Gremlin API](grap
 
 ## Prerequisites
 
-If you don't already have Visual Studio 2019 installed, you can download and use the **free** [Visual Studio 2019 Community Edition](https://www.visualstudio.com/downloads/). Make sure that you enable **Azure development** during the Visual Studio setup.
+Latest [!INCLUDE [cosmos-db-visual-studio](../includes/cosmos-db-visual-studio.md)]
 
 [!INCLUDE [quickstarts-free-trial-note](../../../includes/quickstarts-free-trial-note.md)]
 
@@ -42,7 +42,7 @@ If you don't already have Visual Studio 2019 installed, you can download and use
 
 ## Clone the sample application
 
-Now let's clone a Gremlin API app from GitHub, set the connection string, and run it. You'll see how easy it is to work with data programmatically. 
+Now let's clone a Gremlin API app from GitHub, set the connection string, and run it. You'll see how easy it's to work with data programmatically. 
 
 1. Open a command prompt, create a new folder named git-samples, then close the command prompt.
 
@@ -64,10 +64,10 @@ Now let's clone a Gremlin API app from GitHub, set the connection string, and ru
 
 4. Then open Visual Studio and open the solution file.
 
-5. Restore the NuGet packages in the project. This should include the Gremlin.Net driver, as well as the Newtonsoft.Json package.
+5. Restore the NuGet packages in the project. This should include the Gremlin.Net driver, and the Newtonsoft.Json package.
 
 
-6. You can also install the [email protected] driver manually using the Nuget package manager, or the [nuget command-line utility](/nuget/install-nuget-client-tools): 
+6. You can also install the [email protected] driver manually using the NuGet package manager, or the [NuGet command-line utility](/nuget/install-nuget-client-tools): 
 
     ```bash
     nuget install Gremlin.NET -Version 3.4.6
@@ -114,7 +114,7 @@ Now go back to the Azure portal to get your connection string information and co
 
 1. Next, navigate to the **Keys** tab and copy the **PRIMARY KEY** value from the Azure portal. 
 
-1. After you have copied the URI and PRIMARY KEY of your account, save them to a new environment variable on the local machine running the application. To set the environment variable, open a command prompt window, and run the following command. Make sure to replace <Your_Azure_Cosmos_account_URI> and <Your_Azure_Cosmos_account_PRIMARY_KEY> values.
+1. After you've copied the URI and PRIMARY KEY of your account, save them to a new environment variable on the local machine running the application. To set the environment variable, open a command prompt window, and run the following command. Make sure to replace <Your_Azure_Cosmos_account_URI> and <Your_Azure_Cosmos_account_PRIMARY_KEY> values.
 
    ```console
    setx Host "<your Azure Cosmos account name>.gremlin.cosmosdb.azure.com"
@@ -132,19 +132,19 @@ You've now updated your app with all the info it needs to communicate with Azure
 
 ## Run the console app
 
-Click CTRL + F5 to run the application. The application will print both the Gremlin query commands and results in the console.
+Select CTRL + F5 to run the application. The application will print both the Gremlin query commands and results in the console.
 
    The console window displays the vertexes and edges being added to the graph. When the script completes, press ENTER to close the console window.
 
 ## Browse using the Data Explorer
 
 You can now go back to Data Explorer in the Azure portal and browse and query your new graph data.
 
-1. In Data Explorer, the new database appears in the Graphs pane. Expand the database and container nodes, and then click **Graph**.
+1. In Data Explorer, the new database appears in the Graphs pane. Expand the database and container nodes, and then select **Graph**.
 
-2. Click the **Apply Filter** button to use the default query to view all the vertices in the graph. The data generated by the sample app is displayed in the Graphs pane.
+2. Select the **Apply Filter** button to use the default query to view all the vertices in the graph. The data generated by the sample app is displayed in the Graphs pane.
 
-    You can zoom in and out of the graph, you can expand the graph display space, add additional vertices, and move vertices on the display surface.
+    You can zoom in and out of the graph, you can expand the graph display space, add extra vertices, and move vertices on the display surface.
 
     :::image type="content" source="./media/create-graph-dotnet/graph-explorer.png" alt-text="View the graph in Data Explorer in the Azure portal":::
 

articles/cosmos-db/includes/cosmos-db-emulator-vs.md

@@ -0,0 +1,8 @@
+---
+author: seesharprun
+ms.service: cosmos-db
+ms.topic: include
+ms.date: 05/02/2022
+ms.author: sidandrews
+---
+Visual Studio with the Azure development workload. You can get started with the *free* [Visual Studio Community](https://visualstudio.microsoft.com/vs/community/) IDE. Enable the **Azure development** workload during Visual Studio setup.