Merge pull request #218724 from seesharprun/cosmos-dev-guide-metadata

Cosmos DB | [BULK] Update metadata and Markdown for API for MongoDB/NoSQL/Table + .NET/JS/Python developer guides

Author: Court72

articles/cosmos-db/mongodb/how-to-dotnet-get-started.md

@@ -1,17 +1,18 @@
 ---
-title: Get started with Azure Cosmos DB for MongoDB and .NET
+title: Get started with Azure Cosmos DB for MongoDB using .NET
 description: Get started developing a .NET application that works with Azure Cosmos DB for MongoDB. This article helps you learn how to set up a project and configure access to an Azure Cosmos DB for MongoDB database.
-author: alexwolfmsft
-ms.author: alexwolf
+author: seesharprun
+ms.author: sidandrews
 ms.service: cosmos-db
 ms.subservice: mongodb
-ms.devlang: dotnet
+ms.devlang: csharp
 ms.topic: how-to
 ms.date: 10/17/2022
-ms.custom: devx-track-dotnet, ignite-2022
+ms.custom: devx-track-dotnet, ignite-2022, devguide-csharp, cosmos-db-dev-journey
 ---
 
-# Get started with Azure Cosmos DB for MongoDB and .NET Core
+# Get started with Azure Cosmos DB for MongoDB using .NET
+
 [!INCLUDE[MongoDB](../includes/appliesto-mongodb.md)]
 
 This article shows you how to connect to Azure Cosmos DB for MongoDB using .NET Core and the relevant NuGet packages. Once connected, you can perform operations on databases, collections, and documents.
@@ -21,17 +22,16 @@ This article shows you how to connect to Azure Cosmos DB for MongoDB using .NET
 
 [API for MongoDB reference documentation](https://docs.mongodb.com/drivers/csharp) | [MongoDB Package (NuGet)](https://www.nuget.org/packages/MongoDB.Driver)
 
-
 ## Prerequisites
 
-* An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free).
-* [.NET 6.0](https://dotnet.microsoft.com/en-us/download)
-* [Azure Command-Line Interface (CLI)](/cli/azure/) or [Azure PowerShell](/powershell/azure/)
-* [Azure Cosmos DB for MongoDB resource](quickstart-dotnet.md#create-an-azure-cosmos-db-account)
+- An Azure account with an active subscription. [Create an account for free](https://azure.microsoft.com/free).
+- [.NET 6.0](https://dotnet.microsoft.com/download)
+- [Azure Command-Line Interface (CLI)](/cli/azure/) or [Azure PowerShell](/powershell/azure/)
+- [Azure Cosmos DB for MongoDB resource](quickstart-dotnet.md#create-an-azure-cosmos-db-account)
 
 ## Create a new .NET Core app
 
-1. Create a new .NET Core application in an empty folder using your preferred terminal. For this scenario you'll use a console application. Use the [``dotnet new``](/dotnet/core/tools/dotnet-new) command to create and name the console app.
+1. Create a new .NET Core application in an empty folder using your preferred terminal. For this scenario, you'll use a console application. Use the [``dotnet new``](/dotnet/core/tools/dotnet-new) command to create and name the console app.
 
     ```console
     dotnet new console -o app
@@ -114,10 +114,10 @@ The following guides show you how to use each of these classes to build your app
 
 **Guide**:
 
-* [Manage databases](how-to-dotnet-manage-databases.md)  
-* [Manage collections](how-to-dotnet-manage-collections.md) 
-* [Manage documents](how-to-dotnet-manage-documents.md) 
-* [Use queries to find documents](how-to-dotnet-manage-queries.md) 
+- [Manage databases](how-to-dotnet-manage-databases.md)  
+- [Manage collections](how-to-dotnet-manage-collections.md)
+- [Manage documents](how-to-dotnet-manage-documents.md)
+- [Use queries to find documents](how-to-dotnet-manage-queries.md)
 
 ## See also
 
@@ -126,7 +126,7 @@ The following guides show you how to use each of these classes to build your app
 
 ## Next steps
 
-Now that you've connected to a API for MongoDB account, use the next guide to create and manage databases.
+Now that you've connected to an API for MongoDB account, use the next guide to create and manage databases.
 
 > [!div class="nextstepaction"]
 > [Create a database in Azure Cosmos DB for MongoDB using .NET](how-to-dotnet-manage-databases.md)

articles/cosmos-db/mongodb/how-to-dotnet-manage-collections.md

@@ -1,14 +1,14 @@
 ---
 title: Create a collection in Azure Cosmos DB for MongoDB using .NET
 description: Learn how to work with a collection in your Azure Cosmos DB for MongoDB database using the .NET SDK.
-author: alexwolfmsft
-ms.author: alexwolf
+author: seesharprun
+ms.author: sidandrews
 ms.service: cosmos-db
 ms.subservice: mongodb
-ms.devlang: dotnet
+ms.devlang: csharp
 ms.topic: how-to
 ms.date: 07/22/2022
-ms.custom: devx-track-dotnet, ignite-2022
+ms.custom: devx-track-dotnet, ignite-2022, devguide-csharp, cosmos-db-dev-journey
 ---
 
 # Manage a collection in Azure Cosmos DB for MongoDB using .NET
@@ -28,31 +28,31 @@ In Azure Cosmos DB, a collection is analogous to a table in a relational databas
 
 Here are some quick rules when naming a collection:
 
-* Keep collection names between 3 and 63 characters long
-* Collection names can only contain lowercase letters, numbers, or the dash (-) character.
-* Container names must start with a lowercase letter or number.
+- Keep collection names between 3 and 63 characters long
+- Collection names can only contain lowercase letters, numbers, or the dash (-) character.
+- Container names must start with a lowercase letter or number.
 
 ## Get collection instance
 
 Use an instance of the **Collection** class to access the collection on the server.
 
-* [MongoClient.Database.Collection](https://mongodb.github.io/node-mongodb-native/4.7/classes/Collection.html)
+- [MongoClient.Database.Collection](https://mongodb.github.io/node-mongodb-native/4.7/classes/Collection.html)
 
 The following code snippets assume you've already created your [client connection](how-to-dotnet-get-started.md#create-mongoclient-with-connection-string).
 
 ## Create a collection
 
 To create a collection, insert a document into the collection.
 
-* [MongoClient.Database.Collection](https://mongodb.github.io/node-mongodb-native/4.5/classes/Db.html#collection)
-* [MongoClient.Database.Collection.InsertOne](https://mongodb.github.io/node-mongodb-native/4.7/classes/Collection.html#insertOne)
-* [MongoClient.Database.Collection.InsertMany](https://mongodb.github.io/node-mongodb-native/4.7/classes/Collection.html#insertMany)
+- [MongoClient.Database.Collection](https://mongodb.github.io/node-mongodb-native/4.5/classes/Db.html#collection)
+- [MongoClient.Database.Collection.InsertOne](https://mongodb.github.io/node-mongodb-native/4.7/classes/Collection.html#insertOne)
+- [MongoClient.Database.Collection.InsertMany](https://mongodb.github.io/node-mongodb-native/4.7/classes/Collection.html#insertMany)
 
 :::code language="csharp" source="~/azure-cosmos-mongodb-dotnet/110-manage-collections/program.cs" id="create_collection":::
 
 ## Drop a collection
 
-* [MongoClient.Db.dropCollection](https://mongodb.github.io/node-mongodb-native/4.7/classes/Db.html#dropCollection)
+- [MongoClient.Db.dropCollection](https://mongodb.github.io/node-mongodb-native/4.7/classes/Db.html#dropCollection)
 
 Drop the collection from the database to remove it permanently. However, the next insert or update operation that accesses the collection will create a new collection with that name.
 
@@ -62,11 +62,10 @@ Drop the collection from the database to remove it permanently. However, the nex
 
 An index is used by the MongoDB query engine to improve performance to database queries.
 
-* [MongoClient.Database.Collection.indexes](https://mongodb.github.io/node-mongodb-native/4.7/classes/Collection.html#indexes)
+- [MongoClient.Database.Collection.indexes](https://mongodb.github.io/node-mongodb-native/4.7/classes/Collection.html#indexes)
 
 :::code language="csharp" source="~/azure-cosmos-mongodb-dotnet/110-manage-collections/program.cs" id="get_indexes":::
 
-
 ## See also
 
 - [Get started with Azure Cosmos DB for MongoDB and .NET](how-to-dotnet-get-started.md)

articles/cosmos-db/mongodb/how-to-dotnet-manage-databases.md

@@ -1,14 +1,14 @@
 ---
 title: Manage a MongoDB database using .NET
 description: Learn how to manage your Azure Cosmos DB resource when it provides the API for MongoDB with a .NET SDK.
-author: alexwolfmsft
-ms.author: alexwolf
+author: seesharprun
+ms.author: sidandrews
 ms.service: cosmos-db
 ms.subservice: mongodb
-ms.devlang: dotnet
+ms.devlang: csharp
 ms.topic: how-to
 ms.date: 07/22/2022
-ms.custom: devx-track-dotnet, ignite-2022
+ms.custom: devx-track-dotnet, ignite-2022, devguide-csharp, cosmos-db-dev-journey
 ---
 
 # Manage a MongoDB database using .NET
@@ -28,9 +28,9 @@ In Azure Cosmos DB, a database is analogous to a namespace. When you create a da
 
 Here are some quick rules when naming a database:
 
-* Keep database names between 3 and 63 characters long
-* Database names can only contain lowercase letters, numbers, or the dash (-) character.
-* Database names must start with a lowercase letter or number.
+- Keep database names between 3 and 63 characters long
+- Database names can only contain lowercase letters, numbers, or the dash (-) character.
+- Database names must start with a lowercase letter or number.
 
 Once created, the URI for a database is in this format:
 
@@ -40,26 +40,26 @@ Once created, the URI for a database is in this format:
 
 You can use the `MongoClient` to get an instance of a database, or create one if it doesn't exist already. The `MongoDatabase` class provides access to collections and their documents.
 
-* [MongoClient](https://mongodb.github.io/mongo-csharp-driver/2.16/apidocs/html/T_MongoDB_Driver_MongoClient.htm)
-* [MongoClient.Database](https://mongodb.github.io/mongo-csharp-driver/2.16/apidocs/html/T_MongoDB_Driver_MongoDatabase.htm)
+- [MongoClient](https://mongodb.github.io/mongo-csharp-driver/2.16/apidocs/html/T_MongoDB_Driver_MongoClient.htm)
+- [MongoClient.Database](https://mongodb.github.io/mongo-csharp-driver/2.16/apidocs/html/T_MongoDB_Driver_MongoDatabase.htm)
 
-The following code snippet creates a new database by inserting a document into a collection. Remember, the database will not be created until it is needed for this type of operation.
+The following code snippet creates a new database by inserting a document into a collection. Remember, the database won't be created until it's needed for this type of operation.
 
 :::code language="csharp" source="~/azure-cosmos-mongodb-dotnet/105-manage-databases/program.cs" id="create_database":::
 
 ## Get an existing database
 
 You can also retrieve an existing database by name using the `GetDatabase` method to access its collections and documents.
 
-* [MongoClient.GetDatabase](https://mongodb.github.io/mongo-csharp-driver/2.17/apidocs/html/M_MongoDB_Driver_MongoClient_GetDatabase.htm)
+- [MongoClient.GetDatabase](https://mongodb.github.io/mongo-csharp-driver/2.17/apidocs/html/M_MongoDB_Driver_MongoClient_GetDatabase.htm)
 
 :::code language="csharp" source="~/azure-cosmos-mongodb-dotnet/105-manage-databases/program.cs" id="get_database":::
 
 ## Get a list of all databases
 
 You can retrieve a list of all the databases on the server using the `MongoClient`.
 
-* [MongoClient.Database.ListDatabaseNames](https://mongodb.github.io/mongo-csharp-driver/2.17/apidocs/html/M_MongoDB_Driver_MongoClient_ListDatabaseNames_3.htm)
+- [MongoClient.Database.ListDatabaseNames](https://mongodb.github.io/mongo-csharp-driver/2.17/apidocs/html/M_MongoDB_Driver_MongoClient_ListDatabaseNames_3.htm)
 
 :::code language="csharp" source="~/azure-cosmos-mongodb-dotnet/105-manage-databases/program.cs" id="get_all_databases":::
 
@@ -69,9 +69,9 @@ This technique can then be used to check if a database already exists.
 
 ## Drop a database
 
-A database is removed from the server using the `DropDatabase` method on the DB class. 
+A database is removed from the server using the `DropDatabase` method on the DB class.
 
-* [MongoClient.DropDatabase](https://mongodb.github.io/mongo-csharp-driver/2.17/apidocs/html/M_MongoDB_Driver_MongoClient_DropDatabase_1.htm)
+- [MongoClient.DropDatabase](https://mongodb.github.io/mongo-csharp-driver/2.17/apidocs/html/M_MongoDB_Driver_MongoClient_DropDatabase_1.htm)
 
 :::code language="csharp" source="~/azure-cosmos-mongodb-dotnet/105-manage-databases/program.cs" id="drop_database":::
 

articles/cosmos-db/mongodb/how-to-dotnet-manage-documents.md

@@ -1,14 +1,14 @@
 ---
 title: Create a document in Azure Cosmos DB for MongoDB using .NET
 description: Learn how to work with a document in your Azure Cosmos DB for MongoDB database using the .NET SDK.
-author: alexwolfmsft
-ms.author: alexwolf
+author: seesharprun
+ms.author: sidandrews
 ms.service: cosmos-db
 ms.subservice: mongodb
-ms.devlang: dotnet
+ms.devlang: csharp
 ms.topic: how-to
 ms.date: 07/22/2022
-ms.custom: devx-track-dotnet, ignite-2022
+ms.custom: devx-track-dotnet, ignite-2022, devguide-csharp, cosmos-db-dev-journey
 ---
 
 # Manage a document in Azure Cosmos DB for MongoDB using .NET
@@ -26,42 +26,46 @@ Manage your MongoDB documents with the ability to insert, update, and delete doc
 
 Insert one or many documents, defined with a JSON schema, into your collection.
 
-* [MongoClient.Database.Collection.InsertOne](https://mongodb.github.io/mongo-csharp-driver/2.17/apidocs/html/M_MongoDB_Driver_IMongoCollection_1_InsertOne_1.htm)
-* [MongoClient.Database.Collection.InsertMany](https://mongodb.github.io/mongo-csharp-driver/2.17/apidocs/html/M_MongoDB_Driver_IMongoCollection_1_InsertMany_1.htm)
+- [MongoClient.Database.Collection.InsertOne](https://mongodb.github.io/mongo-csharp-driver/2.17/apidocs/html/M_MongoDB_Driver_IMongoCollection_1_InsertOne_1.htm)
+- [MongoClient.Database.Collection.InsertMany](https://mongodb.github.io/mongo-csharp-driver/2.17/apidocs/html/M_MongoDB_Driver_IMongoCollection_1_InsertMany_1.htm)
 
 :::code language="csharp" source="~/azure-cosmos-mongodb-dotnet/115-manage-documents/program.cs" id="insert_document":::
 
 ## Update a document
 
-To update a document, specify the query filter used to find the document along with a set of properties of the document that should be updated. 
+To update a document, specify the query filter used to find the document along with a set of properties of the document that should be updated.
 
-* [MongoClient.Database.Collection.UpdateOne](https://mongodb.github.io/mongo-csharp-driver/2.17/apidocs/html/M_MongoDB_Driver_IMongoCollection_1_UpdateOne_1.htm)
-* [MongoClient.Database.Collection.UpdateMany](https://mongodb.github.io/mongo-csharp-driver/2.17/apidocs/html/M_MongoDB_Driver_IMongoCollection_1_UpdateMany_1.htm)
+- [MongoClient.Database.Collection.UpdateOne](https://mongodb.github.io/mongo-csharp-driver/2.17/apidocs/html/M_MongoDB_Driver_IMongoCollection_1_UpdateOne_1.htm)
+- [MongoClient.Database.Collection.UpdateMany](https://mongodb.github.io/mongo-csharp-driver/2.17/apidocs/html/M_MongoDB_Driver_IMongoCollection_1_UpdateMany_1.htm)
 
 :::code language="csharp" source="~/azure-cosmos-mongodb-dotnet/115-manage-documents/program.cs" id="update_document":::
 
 ## Bulk updates to a collection
 
-You can perform several different types of operations at once with the **bulkWrite** operation. Learn more about how to [optimize bulk writes for Azure Cosmos DB](optimize-write-performance.md#tune-for-the-optimal-batch-size-and-thread-count). 
+You can perform several different types of operations at once with the **bulkWrite** operation. Learn more about how to [optimize bulk writes for Azure Cosmos DB](optimize-write-performance.md#tune-for-the-optimal-batch-size-and-thread-count).
 
 The following bulk operations are available:
 
-* [MongoClient.Database.Collection.BulkWrite](https://mongodb.github.io/mongo-csharp-driver/2.17/apidocs/html/M_MongoDB_Driver_IMongoCollection_1_BulkWrite_1.htm)
+- [MongoClient.Database.Collection.BulkWrite](https://mongodb.github.io/mongo-csharp-driver/2.17/apidocs/html/M_MongoDB_Driver_IMongoCollection_1_BulkWrite_1.htm)
 
-    * insertOne
-    * updateOne
-    * updateMany
-    * deleteOne
-    * deleteMany
+  - insertOne
+
+  - updateOne
+
+  - updateMany
+
+  - deleteOne
+  
+  - deleteMany
 
 :::code language="csharp" source="~/azure-cosmos-mongodb-dotnet/115-manage-documents/program.cs" id="bulk_write":::
 
 ## Delete a document
 
-To delete documents, use a query to define how the documents are found. 
+To delete documents, use a query to define how the documents are found.
 
-* [MongoClient.Database.Collection.DeleteOne](https://mongodb.github.io/mongo-csharp-driver/2.17/apidocs/html/M_MongoDB_Driver_IMongoCollection_1_DeleteOne_1.htm)
-* [MongoClient.Database.Collection.DeleteMany](https://mongodb.github.io/mongo-csharp-driver/2.17/apidocs/html/M_MongoDB_Driver_IMongoCollection_1_DeleteMany_1.htm)
+- [MongoClient.Database.Collection.DeleteOne](https://mongodb.github.io/mongo-csharp-driver/2.17/apidocs/html/M_MongoDB_Driver_IMongoCollection_1_DeleteOne_1.htm)
+- [MongoClient.Database.Collection.DeleteMany](https://mongodb.github.io/mongo-csharp-driver/2.17/apidocs/html/M_MongoDB_Driver_IMongoCollection_1_DeleteMany_1.htm)
 
 :::code language="csharp" source="~/azure-cosmos-mongodb-dotnet/115-manage-documents/program.cs" id="delete_document":::
 

articles/cosmos-db/mongodb/how-to-dotnet-manage-queries.md

@@ -1,14 +1,14 @@
 ---
 title: Query documents in Azure Cosmos DB for MongoDB using .NET
 description: Learn how to query documents in your Azure Cosmos DB for MongoDB database using the .NET SDK.
-author: alexwolfmsft
-ms.author: alexwolf
+author: seesharprun
+ms.author: sidandrews
 ms.service: cosmos-db
 ms.subservice: mongodb
-ms.devlang: dotnet
+ms.devlang: csharp
 ms.topic: how-to
 ms.date: 07/22/2022
-ms.custom: devx-track-dotnet, ignite-2022
+ms.custom: devx-track-dotnet, ignite-2022, devguide-csharp, cosmos-db-dev-journey
 ---
 
 # Query documents in Azure Cosmos DB for MongoDB using .NET
@@ -24,11 +24,11 @@ Use queries to find documents in a collection.
 
 ## Query for documents
 
-To find documents, use a query filter on the collection to define how the documents are found. 
+To find documents, use a query filter on the collection to define how the documents are found.
 
-* [MongoClient.Database.Collection.Find](https://www.mongodb.com/docs/manual/reference/method/db.collection.find/)
-* [FilterDefinition](https://mongodb.github.io/mongo-csharp-driver/2.17/apidocs/html/T_MongoDB_Driver_FilterDefinition_1.htm)
-* [FilterDefinitionBuilder](https://mongodb.github.io/mongo-csharp-driver/2.17/apidocs/html/T_MongoDB_Driver_FilterDefinitionBuilder_1.htm)
+- [MongoClient.Database.Collection.Find](https://www.mongodb.com/docs/manual/reference/method/db.collection.find/)
+- [FilterDefinition](https://mongodb.github.io/mongo-csharp-driver/2.17/apidocs/html/T_MongoDB_Driver_FilterDefinition_1.htm)
+- [FilterDefinitionBuilder](https://mongodb.github.io/mongo-csharp-driver/2.17/apidocs/html/T_MongoDB_Driver_FilterDefinitionBuilder_1.htm)
 
 :::code language="csharp" source="~/azure-cosmos-mongodb-dotnet/125-manage-queries/program.cs" id="query_documents":::