Reword note and Realm renaming

Author: cbullinger

source/sdk/dotnet/compatibility.txt

@@ -12,41 +12,17 @@ Platform and Framework Compatibility - .NET SDK
    :class: singlecol
 
 .. meta::
-  :description: Compatibility information for Atlas Device SDK for .NET.
+   :description: Compatibility information when developing with Atlas Device SDK for .NET.
 
 .. facet::
   :name: genre
   :values: reference
 
-Compatibility
--------------
+Target Platforms
+----------------
 
 The following table shows which .NET
-version(s) you can use with Realm on your target platforms:
-
-.. note::
-
-  The source generator models in .NET SDK v10.18.0 and later
-  require the following:
-
-  - .NET Core 2.0 or later (.NET Framework 5.0 or later)
-  - C# 9.0 or later
-
-  If you are targeting an older version of .NET Framework, your object
-  models must derive from
-  :dotnet-sdk:`RealmObject <reference/Realms.RealmObject.html>`,
-  :dotnet-sdk:`EmbeddedObject <reference/Realms.EmbeddedObject.html>`, or
-  :dotnet-sdk:`AsymmetricObject <reference/Realms.AsymmetricObject.html>`
-  base classes.
-
-  The following example demonstrates how you can adjust your current object
-  models:
-
-  .. code-block:: csharp
-
-     public partial class Person : IRealmObject
-
-     public class Person : RealmObject // Update to inherit from RealmObject
+versions you can use with the SDK on your target platforms:
 
 .. list-table::
    :header-rows: 1
@@ -86,10 +62,36 @@ version(s) you can use with Realm on your target platforms:
      - | Xamarin and Unity for tvOS 9.0 or later.
        | For more information on developing for tvOS, see :ref:`<ios-tvos>`.
 
+.. note:: Compatibility with SDK Object Models
+
+  The source generator models in .NET SDK v10.18.0 and later
+  require the following:
+
+  - .NET Core 2.0 or later (.NET Framework 5.0 or later)
+  - C# 9.0 or later
+
+  If you are targeting an older version of .NET Framework, your object models
+  must derive from the
+  :dotnet-sdk:`RealmObject <reference/Realms.RealmObject.html>`,
+  :dotnet-sdk:`EmbeddedObject <reference/Realms.EmbeddedObject.html>`, or
+  :dotnet-sdk:`AsymmetricObject <reference/Realms.AsymmetricObject.html>`
+  base classes required by the old source generator.
+
+  The following demonstrates how you can adjust your current object
+  models for compatibility with older .NET Frameworks:
+
+  .. code-block:: csharp
+
+     public partial class Person : IRealmObject // Current model
+
+     public class Person : RealmObject // Adjusted to inherit from RealmObject
+
+  For more information, refer to :ref:`dotnet-define-a-realm-object-schema`.
+
 Development Environments
 ------------------------
 
-You can use the following development environments to build Realm apps with
+You can use the following development environments to build apps with
 the .NET SDK:
 
 - Visual Studio 2015 Update 2 or higher for Windows
@@ -98,18 +100,19 @@ the .NET SDK:
 
 .. note::
 
-    The :doc:`Realm .NET SDK </sdk/dotnet>` may be compatible with
-    other versions of Unity, but ``2020.3.12f1 (LTS)`` is the version that the
-    Realm team uses for testing and development. We recommend using
-    this version to ensure your project works with Realm and that
+    The :doc:`.NET SDK </sdk/dotnet>` may be compatible with
+    other versions of Unity, but ``2020.3.12f1 (LTS)`` is the version the
+    SDK team uses for testing and development. We recommend using
+    this version to ensure your project works with the .NET SDK and that
     the install steps match the :doc:`Integrate Realm with Unity
     </sdk/dotnet/unity>` documentation steps because Unity's UI
     often changes between versions.
 
 
 Android Deployment
 ------------------
-Due to some instruction set limitations, Realm does not support
+
+Due to some instruction set limitations, the SDK does not support
 deploying Android apps to the ``armeabi`` ABI. Because default templates often
 have different ABI settings for Debug and Release modes, your app may throw
 a ``System.TypeInitializationException`` exception in Release mode but not when
@@ -125,7 +128,8 @@ checking all of the settings other than ``armeabi``.
 
 Limitations
 ------------
-Realm has limits imposed to balance flexibility with performance. The SDK
+
+The SDK has limits imposed to balance flexibility with performance. The SDK
 throws an exception during app initialization if the following limits are
 exceeded: