adding links to reference docs & other cleanup (#546)

* adding links to reference docs & other cleanup

Author: MongoCaleb

examples/dotnet/Examples/WorkWithRealm.cs

@@ -67,14 +67,14 @@ public async System.Threading.Tasks.Task APIKeys()
             {
                 //:code-block-start:apikey-create
                 var newKey = await user.ApiKeys.CreateAsync("someKeyName");
-                Console.WriteLine($"I created a key named {newKey.Name}. " +
+                Console.WriteLine($"I created a key named {newKey.Name}. " +
                     $"Is it enabled? {newKey.IsEnabled}");
                 //:code-block-end:
             }
             {
                 //:code-block-start:apikey-fetch
                 var key = await user.ApiKeys.FetchAsync(ObjectId.Parse("00112233445566778899aabb"));
-                Console.WriteLine($"I fetched the key named {key.Name}. " +
+                Console.WriteLine($"I fetched the key named {key.Name}. " +
                     $"Is it enabled? {key.IsEnabled}");
                 //:code-block-end:
             }
@@ -83,7 +83,7 @@ public async System.Threading.Tasks.Task APIKeys()
                 var allKeys = await user.ApiKeys.FetchAllAsync();
                 foreach (var key in allKeys)
                 {
-                    Console.WriteLine($"I fetched the key named {key.Name}. " +
+                    Console.WriteLine($"I fetched the key named {key.Name}. " +
                         $"Is it enabled? {key.IsEnabled}");
                 }
                 //:code-block-end:

source/dotnet/migrations.txt

@@ -81,15 +81,9 @@ deletes it.
    ``fullName`` based on the existing ``firstName`` and ``lastName``
    properties:
 
-   .. tabs-realm-languages::
-     
-     
-     .. tab::
-         :tabid: c-sharp
- 
-         .. literalinclude:: /examples/Migrations/LocalMigration/LocalMigration.cs
-           :language: csharp
-           :emphasize-lines: 3, 15
+   .. literalinclude:: /examples/Migrations/LocalMigration/LocalMigration.cs
+      :language: csharp
+      :emphasize-lines: 3, 15
 
 
 .. _dotnet-synced-migration:

source/dotnet/objects.txt

@@ -36,13 +36,8 @@ class implementation.
    optionally include the dog's ``breed`` and a reference to a Person
    object that represents the dog's ``owner``.
 
-   .. tabs-realm-languages::
-
-      .. tab::
-          :tabid: c-sharp
-
-          .. literalinclude:: /examples/Schemas/DogSchema.cs
-              :language: csharp
+   .. literalinclude:: /examples/Schemas/DogSchema.cs
+      :language: csharp
 
 
 Key Concepts
@@ -103,7 +98,7 @@ created, modified, or deleted.
 Primary Key
 ~~~~~~~~~~~
 
-A **primary key** is a String or Integer property that uniquely
+A **primary key** is a string or integer property that uniquely
 identifies an object. You may optionally define a primary key for an
 object type as part of the :ref:`object schema <dotnet-object-schema>`.
 {+client-database+} automatically indexes primary key properties, which

source/dotnet/open-a-realm.txt

@@ -14,16 +14,21 @@ Open and Close a Realm
 
 Open a Synced Realm
 -------------------
-To open a synced {+realm+}, call the ``GetInstanceAsync()`` method, 
-passing in a ``SyncConfiguration`` object that includes the partition name and 
+To open a synced {+realm+}, call the 
+:dotnet-sdk:`GetInstanceAsync() <reference/Realms.Realm.html#Realms_Realm_GetInstanceAsync_Realms_RealmConfigurationBase_System_Threading_CancellationToken_>` 
+method, passing in a 
+:dotnet-sdk:`SyncConfiguration <reference/Realms.Sync.SyncConfiguration.html>` 
+object that includes the partition name and 
 the user. The following code demonstrates this:
 
 .. literalinclude:: /examples/generated/code/start/Examples.codeblock.open-synced-realm.cs
    :language: csharp
 
 In the above example, the code shows how to open the {+realm+} *asynchronously* 
-by calling ``GetInstanceAsync``. You can also open a {+realm+} *synchronously* 
-by calling ``GetInstance``, which is necessary if the device is offline. 
+by calling ``GetInstanceAsync()``. You can also open a {+realm+} *synchronously* 
+by calling the 
+:dotnet-sdk:`GetInstance() <reference/Realms.Realm.html#Realms_Realm_GetInstance_System_String_>` 
+method, which is necessary if the device is offline. 
 
 .. literalinclude:: /examples/generated/code/start/Examples.codeblock.open-synced-realm-sync.cs
    :language: csharp
@@ -37,8 +42,9 @@ by calling ``GetInstance``, which is necessary if the device is offline.
 
 Open a Local (Non-Synced) Realm
 -------------------------------
-When opening a local (non-synced) {+realm+}, pass a ``RealmConfiguration`` 
-object to either ``GetInstanceAsync`` or ``GetInstance``. The following example 
+When opening a local (non-synced) {+realm+}, pass a 
+:dotnet-sdk:`RealmConfiguration <reference/Realms.RealmConfiguration.html#Realms_RealmConfiguration__ctor_System_String_>` 
+object to either ``GetInstanceAsync()`` or ``GetInstance()``. The following example 
 creates a ``RealmConfiguration`` object with a local file path, sets the 
 ``IsReadOnly`` property to ``true``, and then opens a local {+realm+}  with that 
 configuration information:
@@ -58,7 +64,8 @@ object with a ``using`` statement, or wrapping the code that interacts with a
    :language: csharp
 
 If you require a realm object to be shared outside of a single method, be sure 
-to manage its state by calling ``Dispose()``:
+to manage its state by calling the
+:dotnet-sdk:`Dispose() <reference/Realms.Realm.html#Realms_Realm_Dispose>` method:
 
 .. literalinclude:: /examples/generated/code/start/Examples.codeblock.dispose.cs
    :language: csharp

source/examples/generated/code/start/WorkWithRealm.codeblock.apikey-create.cs

@@ -1,3 +1,3 @@
 var newKey = await user.ApiKeys.CreateAsync("someKeyName");
-Console.WriteLine($"I created a key named {newKey.Name}. " +
-    $"Is it enabled? {newKey.IsEnabled}");
+Console.WriteLine($"I created a key named {newKey.Name}. " +
+    $"Is it enabled? {newKey.IsEnabled}");

source/examples/generated/code/start/WorkWithRealm.codeblock.apikey-fetch-all.cs

@@ -1,6 +1,6 @@
 var allKeys = await user.ApiKeys.FetchAllAsync();
 foreach (var key in allKeys)
 {
-    Console.WriteLine($"I fetched the key named {key.Name}. " +
+    Console.WriteLine($"I fetched the key named {key.Name}. " +
         $"Is it enabled? {key.IsEnabled}");
 }

source/examples/generated/code/start/WorkWithRealm.codeblock.apikey-fetch.cs

@@ -1,3 +1,3 @@
 var key = await user.ApiKeys.FetchAsync(ObjectId.Parse("00112233445566778899aabb"));
-Console.WriteLine($"I fetched the key named {key.Name}. " +
-    $"Is it enabled? {key.IsEnabled}");
+Console.WriteLine($"I fetched the key named {key.Name}. " +
+    $"Is it enabled? {key.IsEnabled}");

source/examples/generated/code/start/WorkWithRealm.codeblock.reset-user-3.cs

@@ -1,4 +1,4 @@
 await app.EmailPasswordAuth.CallResetPasswordFunctionAsync(
     userEmail, myNewPassword,
     "<security-question-1-answer>",
-    "<security-question-2-answer>");
+    "<security-question-2-answer>");

source/examples/generated/code/start/WorkWithRealm.cs

@@ -50,19 +50,19 @@ publ async System.Threading.Tasks.Task APIKeys()
         {
 
               var newKey = await user.ApiKeys.CreateAsync("someKeyName");
-              Console.WriteLine($"I created a key named {newKey.Name}. " +
+              Console.WriteLine($"I created a key named {newKey.Name}. " +
                   $"Is it enabled? {newKey.IsEnabled}");
 
 
               var key = await user.ApiKeys.FetchAsync(ObjectId.Parse("00112233445566778899aabb"));
-              Console.WriteLine($"I fetched the key named {key.Name}. " +
+              Console.WriteLine($"I fetched the key named {key.Name}. " +
                   $"Is it enabled? {key.IsEnabled}");
 
 
               var allKeys = await user.ApiKeys.FetchAllAsync();
               foreach (var key in allKeys)
               {
-                  Console.WriteLine($"I fetched the key named {key.Name}. " +
+                  Console.WriteLine($"I fetched the key named {key.Name}. " +
                       $"Is it enabled? {key.IsEnabled}");
               }