Move temp files out of source and resolve build errors

Author: dacharyc

source/includes/api-details/javascript/crud/create-realm-object-description.rst

@@ -210,20 +210,20 @@ other clients.
          Call Serverless Functions
          ~~~~~~~~~~~~~~~~~~~~~~~~~
 
-         You can :ref:`call serverless Functions <ios-call-a-function>`
+         You can :ref:`call serverless Functions <sdks-call-function>`
          from your client application that run in an App Services backend.
 
          Query MongoDB Atlas
          ~~~~~~~~~~~~~~~~~~~
 
-         You can :ref:`query data stored in MongoDB <ios-mongodb-remote-access>`
+         You can :ref:`query data stored in MongoDB <sdks-access-mongodb>`
          directly from your client application code.
 
          Authenticate Users
          ~~~~~~~~~~~~~~~~~~
 
          Authenticate users with built-in and third-party :ref:`authentication
-         providers <ios-authenticate-users>`. Use the authenticated user to
+         providers <sdks-authenticate-users>`. Use the authenticated user to
          access App Services.
 
       .. image:: /images/illustrations/Spot_MauvePurple_APIs_Tech_RealmApp.png

source/includes/api-details/kotlin/crud/create-asymmetric-object-description.rst

@@ -17,12 +17,12 @@ API Reference
 
 The following pages contain API reference documentation for Atlas Device SDKs:
 
-- :ref:`C# API Reference (.NET) <https://www.mongodb.com/docs/realm-sdks/dotnet/latest>`
-- :ref:`C++ API Reference (Doxygen) <https://www.mongodb.com/docs/realm-sdks/cpp/latest/>`
-- :ref:`Dart API Reference <https://pub.dev/documentation/realm/latest/>`
-- :ref:`Java API Reference <https://www.mongodb.com/docs/realm-sdks/java/latest/>`
-- :ref:`Java (Kotlin Extensions) API Reference <https://www.mongodb.com/docs/realm-sdks/java/latest/kotlin-extensions/>`
-- :ref:`JavaScript API Reference (JavaScript & TypeScript) <https://www.mongodb.com/docs/realm-sdks/js/latest/>`
-- :ref:`Kotlin API Reference <https://www.mongodb.com/docs/realm-sdks/kotlin/latest/>`
-- :ref:`Objective-C API Reference <https://www.mongodb.com/docs/realm-sdks/objc/latest>`
-- :ref:`Swift API Reference <https://www.mongodb.com/docs/realm-sdks/swift/latest>`
+- `C# API Reference (.NET) <https://www.mongodb.com/docs/realm-sdks/dotnet/latest>`__
+- `C++ API Reference (Doxygen) <https://www.mongodb.com/docs/realm-sdks/cpp/latest/>`__
+- `Dart API Reference <https://pub.dev/documentation/realm/latest/>`__
+- `Java API Reference <https://www.mongodb.com/docs/realm-sdks/java/latest/>`__
+- `Java (Kotlin Extensions) API Reference <https://www.mongodb.com/docs/realm-sdks/java/latest/kotlin-extensions/>`__
+- `JavaScript API Reference (JavaScript & TypeScript) <https://www.mongodb.com/docs/realm-sdks/js/latest/>`__
+- `Kotlin API Reference <https://www.mongodb.com/docs/realm-sdks/kotlin/latest/>`__
+- `Objective-C API Reference <https://www.mongodb.com/docs/realm-sdks/objc/latest>`__
+- `Swift API Reference <https://www.mongodb.com/docs/realm-sdks/swift/latest>`__

source/includes/api-details/kotlin/crud/create-procedure.rst

@@ -216,7 +216,7 @@ Model
 `````
 
 For more information about modeling an object, refer to: 
-:ref:`sdk-define-a-new-object-type`.
+:ref:`sdks-object-models`.
 
 .. include:: /includes/sdk-examples/crud/create-realm-object-model.rst
 
@@ -366,3 +366,13 @@ For more information about modeling an asymmetric object, refer to:
 :ref:`sdks-asymmetric-objects`.
 
 .. include:: /includes/sdk-examples/crud/create-asymmetric-object-model.rst
+
+.. _sdks-create-unmanaged-copy:
+
+Create an Unmanaged Copy of an Object
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. _sdks-upsert-an-object:
+
+Create or Update an Object (Upsert)
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

source/includes/api-details/kotlin/crud/create-realm-object-description.rst

@@ -21,3 +21,9 @@ Filter Data - Swift SDK
    :class: singlecol
 
 Placeholder page for Swift query engine details.
+
+- Remove the *many* ref targets here and settle on the most relevant ones for
+  each section.
+
+.. _ios-nspredicate-query:
+.. _swift-query-geospatial:

source/includes/api-details/typescript/crud/create-realm-object-description.rst

@@ -35,54 +35,14 @@ Some SDKs also support idiomatic APIs for querying realms in their language.
 Query with Realm SDKs
 ---------------------
 
-For further reading on SDK-specific methods for querying realms, see the documentation
-for your SDK: 
-
-.. tabs::
-
-  .. tab:: Flutter SDK
-    :tabid: flutter
-
-    - :ref:`Filter & Sort Results - Flutter SDK <flutter-filter-results>`
-
-  .. tab:: Java SDK
-    :tabid: java
-
-    - :ref:`Query Engine - Java SDK <java-client-query-engine>`
-    - :ref:`Query with Realm Query Language - Java SDK <java-filter-with-realm-query-language>`
-
-  .. tab:: Kotlin SDK
-    :tabid: kotlin
-
-    - :ref:`Filter Data - Kotlin SDK <kotlin-filter-data>`
-
-  .. tab:: .NET SDK
-    :tabid: dotnet
-
-    - :ref:`Query Engine - .NET SDK <dotnet-client-query-engine>`
-
-  .. tab:: Node.JS SDK
-    :tabid: node
-
-    - :ref:`Query Engine - Node.Js SDK <node-client-query-engine>`
-    - :ref:`Filter Queries - Node.Js SDK <node-filter-queries>`
-
-  .. tab:: React Native SDK
-    :tabid: react-native
-
-    - :ref:`Query Engine - React Native SDK <react-native-client-query-engine>`
-    - :ref:`Filter Queries - React Native SDK <react-native-filter-queries>`
-
-  .. tab:: C++ SDK
-    :tabid: cpp
-
-    The C++ SDK currently implements only a subset of RQL. For examples 
-    querying Realm in the C++ SDK, refer to:
-
-    - :ref:`Filter Data - C++ SDK <cpp-filter-data>`
+For language and SDK-specific methods for querying data, refer to the related
+documentation:
 
+- :ref:`sdks-crud-read`
+- :ref:`Fluent Interface (Java SDK) <java-filter-data>`
+- :ref:`LINQ (.NET SDK) <dotnet-linq>`
+- :ref:`Type-Safe and NSPredicate Queries (Swift SDK) <sdks-filter-data-swift>`
 
-
 .. note:: Swift SDK does not support Realm Query Language
 
    The Swift SDK does not support querying with Realm Query Language.
@@ -892,15 +852,7 @@ Full Text Search
 
 You can use RQL to query on properties that have a full-text search (FTS)
 annotation. FTS supports boolean match word searches, rather than searches for relevance.
-For information on enabling FTS on a property, see the FTS documentation for 
-your SDK:
-
-- :ref:`Flutter SDK <flutter-fts-annotation>`
-- :ref:`Kotlin SDK <kotlin-fts-index>`
-- :ref:`.NET SDK <dotnet-fts-indexes>`
-- :ref:`Node.js SDK <node-set-fts-index>`
-- :ref:`React Native SDK <react-native-set-fts-index>`
-- Swift SDK does not yet support Full-Text Search.
+For information on enabling FTS on a property, refer to :ref:`sdks-fts-property`.
 
 To query these properties, use the ``TEXT`` predicate in your query.
 

source/index.txt

@@ -19,3 +19,14 @@ Configure & Open a Database File
    :class: singlecol
 
 Placeholder page for configuring and opening a realm.
+
+.. _sdks-file-schema:
+
+File Schema
+~~~~~~~~~~~
+
+Placeholder for concept information about the database file schema (realm
+schema). i.e. it's a collection of all the object schemas that the database
+file can manage. Some SDKs require explicit realm file schemas, while others
+automatically manage schemas for any object in your project, and you can
+specify a subset of schemas (objects) when opening a realm.

source/sdk/api-reference.txt

@@ -10,18 +10,38 @@ Define an SDK Object Model
    :depth: 3
    :class: singlecol
 
+.. _sdks-define-objects:
+
+Define an SDK Object
+--------------------
+
 Placeholder page for defining an object model.
 
 .. _sdks-embedded-objects:
 
 Define an Embedded Object
--------------------------
+~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Placeholder for defining an embedded object, so we have a ref target to link to.
 
 .. _sdks-asymmetric-objects:
 
 Define an Asymmetric Object
----------------------------
+~~~~~~~~~~~~~~~~~~~~~~~~~~~
 
 Placeholder for defining an asymmetric object, so we have a ref target to link to.
+
+.. _sdks-define-geospatial-object:
+
+Define a Geospatial Object
+~~~~~~~~~~~~~~~~~~~~~~~~~~
+
+.. _sdks-define-special-property-types:
+
+Define Special Property Types
+-----------------------------
+
+.. _sdks-fts-property:
+
+Define a Full-Text Search Property
+~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~

source/sdk/crud/create.txt

@@ -213,7 +213,7 @@ JSON Object Serialization
 ~~~~~~~~~~~~~~~~~~~~~~~~~
 
 The Event Library converts each event object to a JSON object. Most
-:ref:`Realm types <ios-supported-property-types>` have an 
+:ref:`Realm types <sdks-supported-data-types>` have an 
 analogous JSON representation. For example, a Realm 
 String property becomes a JSON String.
 

source/sdk/crud/query-engines/filter-data-swift-sdk.txt

@@ -10,16 +10,13 @@ MongoDB Stitch (Legacy)
    :titlesonly:
    :hidden:
 
-   Migrate Your Stitch App to Realm </migrate>
    (Legacy) Stitch Documentation <http://stitch-docs-old.s3-website-us-east-1.amazonaws.com/>
    (Legacy) Stitch JavaScript Browser SDK <http://stitch-sdks.s3-website-us-east-1.amazonaws.com/stitch-sdks/js/4/index.html>
    (Legacy) Stitch Java/Android SDK <http://stitch-sdks.s3-website-us-east-1.amazonaws.com/stitch-sdks/java/4/overview-summary.html>
    (Legacy) Stitch Swift/iOS SDK <http://stitch-sdks.s3-website-us-east-1.amazonaws.com/stitch-sdks/swift/6/>
    (Legacy) Stitch React Native SDK <http://stitch-sdks.s3-website-us-east-1.amazonaws.com/stitch-sdks/js-react-native/4/index.html>
    (Legacy) Stitch JavaScript Server SDK <http://stitch-sdks.s3-website-us-east-1.amazonaws.com/stitch-sdks/js-server/4/index.html>
 
-- :doc:`Migrate Your Stitch App to Realm </migrate>`
-
 Stitch Documentation Archives
 -----------------------------
 

source/sdk/crud/query-engines/realm-query-language.txt

@@ -52,7 +52,7 @@ tool to:
 - Validate the data in the realm file
 
 The Realm Studio query bar at the top of the main pane 
-accepts the :ref:`Realm JavaScript query syntax<node-client-query-engine>`. 
+accepts the :ref:`Realm Query Language query syntax <realm-query-language>`. 
 You can query using:
 
 - Comparison operators

source/sdk/files/configure-and-open.txt

@@ -16,8 +16,8 @@ Overview
 Realm Studio gives you tools to make non-breaking changes to your schema. You 
 can:
 
-- :ref:`Add classes to the schema<realm-studio-add-class-to-schema>`
-- :ref:`Add properties to classes<realm-studio-add-property-to-class>`
+- :ref:`Add classes to the schema <realm-studio-add-class-to-schema>`
+- :ref:`Add properties to classes <realm-studio-add-property-to-class>`
 
 .. important::
 
@@ -112,36 +112,5 @@ Realm requires you to increment the version monotonically when
 you change the schema. If you try to open a realm with an updated object 
 schema without migrating, your client will throw an error.
 
-For instructions on how to complete this migration, consult your SDK's 
-migration guide.
-
-.. tabs-realm-sdks::
-
-   .. tab::
-      :tabid: android
-
-      :ref:`Schema Versions & Migrations - Realm Java SDK <java-schema-versions-and-migrations>`
-
-   .. tab::
-      :tabid: ios
-
-      :ref:`Schema Versions & Migrations - Realm Swift SDK <ios-schema-versions-and-migrations>`
-
-   .. tab:: 
-      :tabid: node
-
-      :ref:`Schema Versions & Migrations - Realm Node.js SDK <node-schema-versions-and-migrations>`
-
-   .. tab:: 
-      :tabid: react-native
-    
-      :ref:`Schema Versions & Migrations - Realm React Native SDK <react-native-schema-versions-and-migrations>`
-
-   .. tab:: 
-      :tabid: dotnet
-
-      :ref:`Schema Versions & Migrations - Realm .NET SDK <dotnet-schema-versions-and-migrations>`
-   .. tab:: 
-      :tabid: flutter
-
-      :ref:`Schema Versions & Migrations - Realm Flutter SDK <flutter-manually-migrate-schema>`
+For instructions on how to complete this migration, refer to 
+:ref:`sdks-change-object-model`.