(DOCSP-39525): Consolidate Create and Delete Users page

source/includes/api-details/cpp/users/create-delete-users-delete-users-not-supported.rst

@@ -0,0 +1,5 @@
+The C++ SDK does not have the ability to delete users through the SDK. 
+You can delete users from the server using the :ref:`App Services 
+Admin API <admin-api>` ``delete a user`` endpoints. You could optionally 
+create an :ref:`Atlas Function <functions>` that uses the Admin API to 
+delete a user, and :ref:`call the function from the SDK <sdks-call-function>`.

source/includes/api-details/cpp/users/create-delete-users-remove-users-not-supported.rst

@@ -0,0 +1,3 @@
+The C++ SDK does not have the ability to remove users through the SDK. 
+Instead, you could :ref:`log out the user <sdks-logout>`, and then manually
+delete the user's synced database and cached app files from the filesystem.

source/includes/api-details/csharp/users/create-delete-users-delete-users-description.rst

@@ -0,0 +1,3 @@
+To delete a user, call the :dotnet-sdk:`DeleteUserFromServerAsync(User) 
+<reference/Realms.Sync.App.html#Realms_Sync_App_DeleteUserFromServerAsync_Realms_Sync_User_>` 
+method.

source/includes/api-details/csharp/users/create-delete-users-remove-users-description.rst

@@ -0,0 +1,3 @@
+Call the :dotnet-sdk:`RemoveUserAsync(User) 
+<reference/Realms.Sync.App.html#Realms_Sync_App_RemoveUserAsync_Realms_Sync_User_>` 
+method to remove the user and their data from the device.

source/includes/api-details/dart/users/create-delete-users-delete-users-description.rst

@@ -0,0 +1,2 @@
+Call the :flutter-sdk:`App.deleteUser() <realm/App/deleteUser.html>`
+on a user object to delete the user's account from your App Services App.

source/includes/api-details/dart/users/create-delete-users-remove-users-description.rst

@@ -0,0 +1,2 @@
+Call the :flutter-sdk:`App.removeUser() <realm/latest/realm/App/removeUser.html>`
+on a user object to remove the user and their data from the device.

source/includes/api-details/java/users/create-delete-users-delete-users-not-supported.rst

@@ -0,0 +1,5 @@
+The Java SDK does not have the ability to delete users through the SDK. 
+You can delete users from the server using the :ref:`App Services 
+Admin API <admin-api>` ``delete a user`` endpoints. You could optionally 
+create an :ref:`Atlas Function <functions>` that uses the Admin API to 
+delete a user, and :ref:`call the function from the SDK <sdks-call-function>`.

source/includes/api-details/java/users/create-delete-users-remove-users-description.rst

@@ -0,0 +1,5 @@
+To remove a ``User`` object from your client app, call the
+:java-sdk:`User.remove() <io/realm/mongodb/User.html#remove()>` or
+:java-sdk:`User.removeAsync() 
+<io/realm/mongodb/User.html#removeAsync(io.realm.mongodb.App.Callback)>`
+method.

source/includes/api-details/javascript/users/create-delete-users-delete-users-js-ts-description.rst

@@ -0,0 +1,3 @@
+Call the :js-sdk:`App.deleteUser() <classes/App.html#deleteUser>` method with a
+user object to delete the user from your App Services App. This deletes the
+object from the server in addition to clearing data from the device.

source/includes/api-details/javascript/users/create-delete-users-remove-users-js-ts-description.rst

@@ -0,0 +1,4 @@
+Call the :js-sdk:`App.removeUser()
+<https://www.mongodb.com/docs/realm-sdks/js/latest/classes/App.html#removeUser>` 
+method with a user object to remove the user from the device. This clears user
+data from the device, but does not delete the user from Atlas.

source/includes/api-details/kotlin/users/create-delete-users-delete-users-description.rst

@@ -0,0 +1,3 @@
+To permanently delete a ``User`` object from both your client app 
+*and* the Atlas App Services App, call the :kotlin-sync-sdk:`delete 
+<io.realm.kotlin.mongodb/-user/delete.html>` method on a logged-in user:

source/includes/api-details/kotlin/users/create-delete-users-remove-users-description.rst

@@ -0,0 +1,3 @@
+To remove a ``User`` object from your client app, call the
+:kotlin-sync-sdk:`remove <io.realm.kotlin.mongodb/-user/remove.html>`
+method on a user: 

source/includes/api-details/objectivec/users/create-delete-users-delete-users-description.rst

@@ -0,0 +1,5 @@
+You can call the :objc-sdk:`-deleteWithCompletion 
+<Classes/RLMUser.html#/c:objc(cs)RLMUser(im)deleteWithCompletion:>` 
+method on a :objc-sdk:`RLMUser object <Classes/RLMUser.html>` to delete the
+user object from your App Services App. This deletes the object from the
+server in addition to clearing data from the device.

source/includes/api-details/objectivec/users/create-delete-users-remove-users-description.rst

@@ -0,0 +1,5 @@
+You can call the :objc-sdk:`-removeWithCompletion 
+<Classes/RLMUser.html#/c:objc(cs)RLMUser(im)removeWithCompletion:>` 
+method on a :objc-sdk:`RLMUser object <Classes/RLMUser.html>` to remove the
+user from the device. This clears user data from the device, but does not
+delete the user from Atlas.

source/includes/api-details/swift/users/create-delete-users-delete-users-description.rst

@@ -0,0 +1,5 @@
+You can call the :swift-sdk:`delete 
+<Extensions/User.html#/s:So7RLMUserC10RealmSwiftE6delete7Combine6FutureCyyts5Error_pGyF>` 
+method on a user object to delete the user object from your App Services App. 
+This deletes the object from the server in addition to clearing data from the
+device.

source/includes/api-details/swift/users/create-delete-users-remove-users-description.rst

@@ -0,0 +1,4 @@
+You can call the :swift-sdk:`remove 
+<Extensions/User.html#/s:So7RLMUserC10RealmSwiftE6remove7Combine6FutureCyyts5Error_pGyF>` 
+method on a user object to remove the user from the device. This clears user
+data from the device, but does not delete the user from Atlas.

source/includes/sdk-examples/users/create-delete-users-delete-users-from-atlas.rst

@@ -0,0 +1,69 @@
+.. tabs-drivers::
+
+   tabs:
+     - id: cpp-sdk
+       content: |
+
+         .. literalinclude:: /examples/MissingPlaceholders/api.cpp
+           :language: cpp
+
+     - id: csharp
+       content: |
+
+         .. literalinclude:: /examples/generated/dotnet/WorkWithRealm.snippet.delete-user.cs
+            :language: csharp
+
+     - id: dart
+       content: |
+
+         .. literalinclude:: /examples/generated/flutter/authenticate_users_test.snippet.delete-user.dart
+            :language: dart
+
+     - id: java
+       content: |
+
+         .. literalinclude:: /examples/MissingPlaceholders/api.java
+            :language: java
+
+     - id: java-kotlin
+       content: |
+
+         .. literalinclude:: /examples/MissingPlaceholders/api-java-kotlin.kt
+            :language: kotlin
+
+     - id: javascript
+       content: |
+
+         .. literalinclude:: /examples/generated/node/authenticate.snippet.delete-user.js
+            :language: javascript
+
+     - id: kotlin
+       content: |
+
+         .. literalinclude:: /examples/generated/kotlin/AuthenticationTest.snippet.delete-user.kt
+            :language: kotlin
+
+     - id: objectivec
+       content: |
+
+         .. literalinclude:: /examples/MissingPlaceholders/example.m
+            :language: objectivec
+
+     - id: swift
+       content: |
+
+         **Async/Await**
+
+         .. literalinclude:: /examples/generated/code/start/DeleteUsers.snippet.async-await-delete-user.swift
+            :language: swift
+
+         **Closure-Style**
+
+         .. literalinclude:: /examples/generated/code/start/DeleteUsers.snippet.closure-delete-user.swift
+            :language: swift
+
+     - id: typescript
+       content: |
+
+         .. literalinclude::  /examples/MissingPlaceholders/example.ts
+            :language: typescript

source/includes/sdk-examples/users/create-delete-users-remove-users-from-device.rst

@@ -0,0 +1,62 @@
+.. tabs-drivers::
+
+   tabs:
+     - id: cpp-sdk
+       content: |
+
+         .. literalinclude:: /examples/MissingPlaceholders/api.cpp
+           :language: cpp
+
+     - id: csharp
+       content: |
+
+         .. literalinclude:: /examples/MissingPlaceholders/example.cs
+            :language: csharp
+
+     - id: dart
+       content: |
+
+         .. literalinclude:: /examples/MissingPlaceholders/example.dart
+            :language: dart
+
+     - id: java
+       content: |
+
+         .. literalinclude:: /examples/MissingPlaceholders/example.java
+            :language: java
+
+     - id: java-kotlin
+       content: |
+
+         .. literalinclude:: /examples/MissingPlaceholders/example-java-kotlin.kt
+            :language: kotlin
+
+     - id: javascript
+       content: |
+
+         .. literalinclude:: /examples/MissingPlaceholders/example.js
+            :language: javascript
+
+     - id: kotlin
+       content: |
+
+         .. literalinclude:: /examples/generated/kotlin/AuthenticationTest.snippet.remove-user.kt
+            :language: kotlin
+
+     - id: objectivec
+       content: |
+
+         .. literalinclude:: /examples/MissingPlaceholders/example.m
+            :language: objectivec
+
+     - id: swift
+       content: |
+
+         .. literalinclude:: /examples/MissingPlaceholders/example.swift
+            :language: swift
+
+     - id: typescript
+       content: |
+
+         .. literalinclude::  /examples/MissingPlaceholders/example.ts
+            :language: typescript

source/sdk/users.txt

@@ -13,7 +13,7 @@ Manage Users
 .. toctree::
    :titlesonly:
 
-   Create and Delete Users </sdk/users/create-and-delete-users>
+   Create, Delete, & Remove Users </sdk/users/create-and-delete-users>
    Authenticate Users </sdk/users/authenticate-users>
    Custom User Data </sdk/users/custom-user-data>
    User Metadata </sdk/users/user-metadata>

source/sdk/users/authenticate-users.txt

@@ -21,3 +21,8 @@ Offline Login
 
 Refresh Token Expiration
 ------------------------
+
+.. _sdks-logout:
+
+Log a User Out
+--------------