Apply review feedback

mongodb · Jun 25, 2024 · 19b0f29 · 19b0f29
1 parent fb89087
commit 19b0f29
Show file tree

Hide file tree

Showing 3 changed files with 18 additions and 4 deletions.
diff --git a/source/sdk/crud/create.txt b/source/sdk/crud/create.txt
@@ -36,9 +36,10 @@ synced database using Atlas Device SDK. To learn more about object models and
 how to define them, refer to :ref:`sdks-object-models`.
 
 You can create objects whose object type is managed by the database instance. 
-For more information, refer to 
-:ref:`sdks-configure-and-open-database` or 
-:ref:`sdks-configure-and-open-synced-database`.
+For more information, refer to:
+
+- With Sync: :ref:`sdks-configure-and-open-synced-database`
+- Without Sync: :ref:`sdks-configure-and-open-database`
 
 .. note:: Write to a Synced Database
 
@@ -384,6 +385,14 @@ you do so inside a write transaction.
 Create Objects from JSON
 ~~~~~~~~~~~~~~~~~~~~~~~~
 
+Working with JSON returned from an API is a common development use case. Most
+of the supported SDK languages do not directly support creating objects from
+JSON. However, you may use language or platform-idiomatic APIs to transform
+JSON to a structure that matches your object schema, and create a matching
+object. Or you may :ref:`model unstructured data <sdks-model-unstructured-data>`
+to work with **unstructured data** that is highly variable or whose structure
+is unknown at runtime.
+
 .. tabs-drivers::
 
    .. tab::

diff --git a/source/sdk/crud/create/create-property-types.txt b/source/sdk/crud/create/create-property-types.txt
@@ -474,7 +474,8 @@ Create Set Properties
 ~~~~~~~~~~~~~~~~~~~~~
 
 Like their native counterparts, the SDK's set data type stores unique values.
-These values may be of any supported type except another collection.
+These values may be a Realm object or one of the supported data types.
+It cannot be another collection, an embedded object, or an asymmetric object.
 
 The SDK uses the Set container type to define to-many relationships. A
 **to-many** relationship means that an object is related in a specific

diff --git a/source/sdk/model-data/object-models.txt b/source/sdk/model-data/object-models.txt
@@ -67,3 +67,7 @@ Define a Primary Key
 Placeholder for .NET nullability info, and any other SDKs with similar
 APIs/requirements
 
+.. _sdks-model-unstructured-data:
+
+Model Unstructured Data
+~~~~~~~~~~~~~~~~~~~~~~~