Merge pull request #5478 from segmentio/wenxi/csharp-migration-guide-improvoments

update migration guide

Author: stayseesong

src/connections/sources/catalog/libraries/server/csharp/index.md

@@ -27,7 +27,7 @@ These platforms support Analytics-CSharp:
 ## Getting started
 
 > info ""
-> If you'd like to migrate to Analytics-CSharp from a different library, follow the steps in the [Analytics-CSharp migration guide](/docs/connections/sources/catalog/libraries/server/csharp/migration-guide/). 
+> If you'd like to migrate to Analytics-CSharp from Analytics.NET or Analytics.Xamarin, follow the steps in the [Analytics-CSharp migration guide](/docs/connections/sources/catalog/libraries/server/csharp/migration-guide/). 
 
 To get started with the Analytics-CSharp library: 
 

src/connections/sources/catalog/libraries/server/csharp/migration-guide.md

@@ -5,13 +5,13 @@ strat: csharp
 
 If you’re currently using Analytics.NET or Analytics.Xamarin to send data to Segment, please follow the steps below to migrate to the [Analytics-CSharp library](/docs/connections/sources/catalog/libraries/server/csharp/).  
 
-You can update to Analytics-CSharp in 3 easy steps
-1. Bundle Analytics-CSharp into your app (and remove your previous SDK)
-2. Change the namespaces
-3. Advanced: Run Analytics in Synchronous Mode
+You can update to Analytics-CSharp in 3 steps:
+1. Bundle Analytics-CSharp into your app and remove your previous SDK.
+2. Change the namespaces.
+3. *(Optional)* Use `Reset` to stay anonymous.
 
 
-## Start the Migration
+## Migration steps
 
 1. Add the Analytics-CSharp dependency to your project. 
 
@@ -46,33 +46,33 @@ You can update to Analytics-CSharp in 3 easy steps
         using Segment.Analytics.Compat;
       ```
 
-## Optional Changes
+3. *(Optional)* Update calls that resets the anonymous ID. 
+   
+    The old SDK requires you to provide the anonymous ID. The new SDK generates an Anonymous ID for you if you never call `analytics.Identify`. If you call `Identify` and want to go back to anonymous, the new SDK provides a `Reset` function to achieve that.
 
-1. Change your development settings if you would like to make analytics run synchronously for testing purposes. 
-
-    <br> Before:
-    ```c#                  
-    Analytics.Initialize("YOUR_WRITE_KEY", new Config().SetAsync(false));
-    ```
+      <br> Before:
+      ```c#                  
+      Analytics.Client.Page(null, "Login", new Properties(), new Options()
+      .SetAnonymousId("some-id"));
+      ```
 
-    <br> After:
-    ```c#                  
-    var configuration = new Configuration("YOUR WRITE KEY",
-        useSynchronizeDispatcher: true);
-    var analytics = new Analytics(configuration);
-    ```
+      <br> After:
+      ```c#                  
+      analytics.Reset();
+      ```
 
-2. Review your anonymous ID settings. 
+## Optional changes for unit tests
 
-    <br> Before:
-    ```c#                  
-    Analytics.Client.Page(null, "Login", new Properties(), new Options()
-    .SetAnonymousId("some-id"));
-    ```
+Change your development settings if you would like to make analytics run synchronously for testing purposes.
 
-    The new SDK by default, generates an Anonymous ID for you if you never call `analytics.Identify`. If you've called `Identify` and want to go back to anonymous, try:
+<br> Before:
+  ```c#                  
+  Analytics.Initialize("YOUR_WRITE_KEY", new Config().SetAsync(false));
+  ```
 
-    <br> After:
-    ```c#                  
-    analytics.Reset();
-    ```
+<br> After:
+  ```c#                  
+  var configuration = new Configuration("YOUR WRITE KEY",
+    useSynchronizeDispatcher: true);
+  var analytics = new Analytics(configuration);
+  ```