Merge pull request #107873 from codemillmatt/xam-mongo-qs-fix

updated and fixed xamarin article for latest version of mongo in quickstart

Author: PRMerger6

articles/cosmos-db/create-mongodb-xamarin.md

@@ -6,7 +6,7 @@ ms.service: cosmos-db
 ms.subservice: cosmosdb-mongo
 ms.devlang: dotnet
 ms.topic: quickstart
-ms.date: 06/20/2018
+ms.date: 03/16/2020
 ms.author: masoucou
 
 ---
@@ -22,7 +22,7 @@ ms.author: masoucou
 > * [Golang](create-mongodb-golang.md)
 >  
 
-Azure Cosmos DB is Microsoft’s globally distributed multi-model database service. You can quickly create and query document, key/value, and graph databases, all of which benefit from the global distribution and horizontal scale capabilities at the core of Azure Cosmos DB.
+Azure Cosmos DB is Microsoft's globally distributed multi-model database service. You can quickly create and query document, key/value, and graph databases, all of which benefit from the global distribution and horizontal scale capabilities at the core of Azure Cosmos DB.
 
 This quickstart demonstrates how to create a [Cosmos account configured with Azure Cosmos DB's API for MongoDB](mongodb-introduction.md), document database, and collection using the Azure portal. You'll then build a todo app Xamarin.Forms app by using the [MongoDB .NET driver](https://docs.mongodb.com/ecosystem/drivers/csharp/).
 
@@ -48,12 +48,20 @@ The sample described in this article is compatible with MongoDB.Driver version 2
 
 First, download the sample app from GitHub. It implements a todo app with MongoDB's document storage model.
 
-1. Open a command prompt, create a new folder named git-samples, then close the command prompt.
 
-    ```bash
+
+# [Windows](#tab/windows)
+
+1. On Windows open a command prompt or on Mac open the terminal, create a new folder named git-samples, then close the window.
+
+    ```batch
     md "C:\git-samples"
     ```
 
+    ```bash
+    mkdir '$home\git-samples\
+    ```
+
 2. Open a git terminal window, such as git bash, and use the `cd` command to change to the new folder to install the sample app.
 
     ```bash
@@ -83,6 +91,8 @@ The following snippets are all taken from the `MongoService` class, found at the
     settings.SslSettings =
         new SslSettings() { EnabledSslProtocols = SslProtocols.Tls12 };
 
+    settings.RetryWrites = false;
+
     MongoClient mongoClient = new MongoClient(settings);
     ```
 
@@ -156,6 +166,11 @@ Now go back to the Azure portal to get your connection string information and co
 
 3. Copy your **primary connection string** value from the portal (using the copy button) and make it the value of the **ConnectionString** field in your **APIKeys.cs** file.
 
+4. Remove `&replicaSet=globaldb` from the connection string. You will get a runtime error if you do not remove that value from the query string.
+
+> [!IMPORTANT]
+> You must remove the `&replicaSet=globaldb` key/value pair from the connection string's query string in order to avoid a runtime error.
+
 You've now updated your app with all the info it needs to communicate with Azure Cosmos DB.
 
 ## Run the app