docs: improve organization of SDK config (#409)

* docs: improve organization of SDK config

* update playgrounds

ParseSwift.playground/Pages/1 - Your first Object.xcplaygroundpage/Contents.swift

@@ -41,7 +41,10 @@ struct GameScore: ParseObject {
     //: Your own properties.
     var points: Int?
 
-    //: Implement your own version of merge
+    /*:
+     Optional - implement your own version of merge
+     for faster decoding after updating your `ParseObject`.
+     */
     func merge(with object: Self) throws -> Self {
         var updated = try mergeParse(with: object)
         if updated.shouldRestoreKey(\.points,
@@ -79,7 +82,10 @@ struct GameData: ParseObject {
     //: or else you will need your masterKey to force an upgrade.
     var bytes: ParseBytes?
 
-    //: Implement your own version of merge
+    /*:
+     Optional - implement your own version of merge
+     for faster decoding after updating your `ParseObject`.
+     */
     func merge(with object: Self) throws -> Self {
         var updated = try mergeParse(with: object)
         if shouldRestoreKey(\.polygon,
@@ -120,10 +126,13 @@ score.save { result in
         assert(savedScore.updatedAt != nil)
         assert(savedScore.points == 10)
 
-        /*: To modify, need to make it a var as the value type
-            was initialized as immutable. Using `mergeable`
-            allows you to only send the updated keys to the
-            parse server as opposed to the whole object.
+        /*:
+         To modify, you need to make it a var as the value type
+         was initialized as immutable. Using `mergeable`
+         allows you to only send the updated keys to the
+         parse server as opposed to the whole object. Make sure
+         to call `mergeable` before you begin
+         your first mutation of your `ParseObject`.
         */
         var changedScore = savedScore.mergeable
         changedScore.points = 200
@@ -210,15 +219,18 @@ assert(savedScore?.createdAt != nil)
 assert(savedScore?.updatedAt != nil)
 assert(savedScore?.points == 10)
 
-/*:  To modify, need to make it a var as the value type
-    was initialized as immutable. Using `mergeable`
-    allows you to only send the updated keys to the
-    parse server as opposed to the whole object.
+/*:
+ To modify, you need to make a mutable copy of `savedScore`.
+ Instead of using `mergeable` this time, we will use the `set()`
+ method which allows us to accomplish the same thing
+ as `mergeable`. You can choose to use `set()` or
+ `mergeable` as long as you use either before you begin
+ your first mutation of your `ParseObject`.
 */
-guard var changedScore = savedScore?.mergeable else {
+guard var changedScore = savedScore else {
     fatalError("Should have produced mutable changedScore")
 }
-changedScore.points = 200
+changedScore = changedScore.set(\.points, to: 200)
 
 let savedChangedScore: GameScore?
 do {

ParseSwift.playground/Pages/10 - Cloud Code.xcplaygroundpage/Contents.swift

@@ -144,7 +144,10 @@ struct GameScore: ParseObject {
     //: Your own properties.
     var points: Int?
 
-    //: Implement your own version of merge
+    /*:
+     Optional - implement your own version of merge
+     for faster decoding after updating your `ParseObject`.
+     */
     func merge(with object: Self) throws -> Self {
         var updated = try mergeParse(with: object)
         if updated.shouldRestoreKey(\.points,

ParseSwift.playground/Pages/11 - LiveQuery.xcplaygroundpage/Contents.swift

@@ -23,7 +23,10 @@ struct GameScore: ParseObject {
     var location: ParseGeoPoint?
     var name: String?
 
-    //: Implement your own version of merge
+    /*:
+     Optional - implement your own version of merge
+     for faster decoding after updating your `ParseObject`.
+     */
     func merge(with object: Self) throws -> Self {
         var updated = try mergeParse(with: object)
         if updated.shouldRestoreKey(\.points,

ParseSwift.playground/Pages/12 - Roles and Relations.xcplaygroundpage/Contents.swift

@@ -32,7 +32,10 @@ struct User: ParseUser {
     var customKey: String?
     var scores: ParseRelation<Self>?
 
-    //: Implement your own version of merge
+    /*:
+     Optional - implement your own version of merge
+     for faster decoding after updating your `ParseObject`.
+     */
     func merge(with object: Self) throws -> Self {
         var updated = try mergeParse(with: object)
         if updated.shouldRestoreKey(\.customKey,
@@ -55,7 +58,10 @@ struct Role<RoleUser: ParseUser>: ParseRole {
     //: Provided by Role.
     var name: String?
 
-    //: Implement your own version of merge
+    /*:
+     Optional - implement your own version of merge
+     for faster decoding after updating your `ParseObject`.
+     */
     func merge(with object: Self) throws -> Self {
         var updated = try mergeParse(with: object)
         if updated.shouldRestoreKey(\.name,
@@ -78,7 +84,10 @@ struct GameScore: ParseObject {
     //: Your own properties.
     var points: Int?
 
-    //: Implement your own version of merge
+    /*:
+     Optional - implement your own version of merge
+     for faster decoding after updating your `ParseObject`.
+     */
     func merge(with object: Self) throws -> Self {
         var updated = try mergeParse(with: object)
         if updated.shouldRestoreKey(\.points,

ParseSwift.playground/Pages/13 - Operations.xcplaygroundpage/Contents.swift

@@ -25,7 +25,10 @@ struct GameScore: ParseObject {
     var points: Int?
     var name: String?
 
-    //: Implement your own version of merge
+    /*:
+     Optional - implement your own version of merge
+     for faster decoding after updating your `ParseObject`.
+     */
     func merge(with object: Self) throws -> Self {
         var updated = try mergeParse(with: object)
         if updated.shouldRestoreKey(\.points,

ParseSwift.playground/Pages/15 - Custom ObjectId.xcplaygroundpage/Contents.swift

@@ -34,7 +34,10 @@ struct GameScore: ParseObject {
     //: Your own properties.
     var points: Int?
 
-    //: Implement your own version of merge
+    /*:
+     Optional - implement your own version of merge
+     for faster decoding after updating your `ParseObject`.
+     */
     func merge(with object: Self) throws -> Self {
         var updated = try mergeParse(with: object)
         if updated.shouldRestoreKey(\.points,
@@ -79,10 +82,11 @@ score.save { result in
         //: Any changes to `createdAt` and `objectId` will not be saved to the server.
         print("Saved score: \(savedScore)")
 
-        /*: To modify, need to make it a var as the value type
-            was initialized as immutable. Using `.mergeable`
-            allows you to only send the updated keys to the
-            parse server as opposed to the whole object.
+        /*:
+         To modify, need to make it a var as the value type
+         was initialized as immutable. Using `.mergeable` or `set()`
+         allows you to only send the updated keys to the
+         parse server as opposed to the whole object.
         */
         var changedScore = savedScore.mergeable
         changedScore.points = 200

ParseSwift.playground/Pages/17 - SwiftUI - Finding Objects.xcplaygroundpage/Contents.swift

@@ -33,7 +33,10 @@ struct GameScore: ParseObject {
     var name: String?
     var myFiles: [ParseFile]?
 
-    //: Implement your own version of merge
+    /*:
+     Optional - implement your own version of merge
+     for faster decoding after updating your `ParseObject`.
+     */
     func merge(with object: Self) throws -> Self {
         var updated = try mergeParse(with: object)
         if updated.shouldRestoreKey(\.points,

ParseSwift.playground/Pages/18 - SwiftUI - Finding Objects With Custom ViewModel.xcplaygroundpage/Contents.swift

@@ -33,7 +33,10 @@ struct GameScore: ParseObject {
     var location: ParseGeoPoint?
     var name: String?
 
-    //: Implement your own version of merge
+    /*:
+     Optional - implement your own version of merge
+     for faster decoding after updating your `ParseObject`.
+     */
     func merge(with object: Self) throws -> Self {
         var updated = try mergeParse(with: object)
         if updated.shouldRestoreKey(\.points,

ParseSwift.playground/Pages/19 - SwiftUI - LiveQuery.xcplaygroundpage/Contents.swift

@@ -31,7 +31,10 @@ struct GameScore: ParseObject {
     var location: ParseGeoPoint?
     var name: String?
 
-    //: Implement your own version of merge
+    /*:
+     Optional - implement your own version of merge
+     for faster decoding after updating your `ParseObject`.
+     */
     func merge(with object: Self) throws -> Self {
         var updated = try mergeParse(with: object)
         if updated.shouldRestoreKey(\.points,

ParseSwift.playground/Pages/2 - Finding Objects.xcplaygroundpage/Contents.swift

@@ -26,7 +26,10 @@ struct GameScore: ParseObject {
     var oldScore: Int?
     var isHighest: Bool?
 
-    //: Implement your own version of merge
+    /*:
+     Optional - implement your own version of merge
+     for faster decoding after updating your `ParseObject`.
+     */
     func merge(with object: Self) throws -> Self {
         var updated = try mergeParse(with: object)
         if updated.shouldRestoreKey(\.points,

ParseSwift.playground/Pages/20 - Cloud Schemas.xcplaygroundpage/Contents.swift

@@ -32,7 +32,10 @@ struct User: ParseUser {
     //: Your custom keys.
     var customKey: String?
 
-    //: Implement your own version of merge
+    /*:
+     Optional - implement your own version of merge
+     for faster decoding after updating your `ParseObject`.
+     */
     func merge(with object: Self) throws -> Self {
         var updated = try mergeParse(with: object)
         if updated.shouldRestoreKey(\.customKey,
@@ -59,7 +62,10 @@ struct GameScore2: ParseObject {
     var owner: User?
     var rivals: [User]?
 
-    //: Implement your own version of merge
+    /*:
+     Optional - implement your own version of merge
+     for faster decoding after updating your `ParseObject`.
+     */
     func merge(with object: Self) throws -> Self {
         var updated = try mergeParse(with: object)
         if updated.shouldRestoreKey(\.points,

ParseSwift.playground/Pages/21 - Cloud Push Notifications.xcplaygroundpage/Contents.swift

@@ -37,7 +37,10 @@ struct Installation: ParseInstallation {
     //: Your custom keys
     var customKey: String?
 
-    //: Implement your own version of merge
+    /*:
+     Optional - implement your own version of merge
+     for faster decoding after updating your `ParseObject`.
+     */
     func merge(with object: Self) throws -> Self {
         var updated = try mergeParse(with: object)
         if updated.shouldRestoreKey(\.customKey,

ParseSwift.playground/Pages/23 - Cloud Hook Triggers.xcplaygroundpage/Contents.swift

@@ -25,7 +25,10 @@ struct GameScore: ParseObject {
     //: Your own properties.
     var points: Int?
 
-    //: Implement your own version of merge
+    /*:
+     Optional - implement your own version of merge
+     for faster decoding after updating your `ParseObject`.
+     */
     func merge(with object: Self) throws -> Self {
         var updated = try mergeParse(with: object)
         if updated.shouldRestoreKey(\.points,

ParseSwift.playground/Pages/3 - User - Sign Up.xcplaygroundpage/Contents.swift

@@ -31,7 +31,10 @@ struct User: ParseUser {
     //: Your custom keys.
     var customKey: String?
 
-    //: Implement your own version of merge
+    /*:
+     Optional - implement your own version of merge
+     for faster decoding after updating your `ParseObject`.
+     */
     func merge(with object: Self) throws -> Self {
         var updated = try mergeParse(with: object)
         if updated.shouldRestoreKey(\.customKey,

ParseSwift.playground/Pages/4 - User - Continued.xcplaygroundpage/Contents.swift

@@ -34,7 +34,10 @@ struct User: ParseUser {
     var targetScore: GameScore?
     var allScores: [GameScore]?
 
-    //: Implement your own version of merge
+    /*:
+     Optional - implement your own version of merge
+     for faster decoding after updating your `ParseObject`.
+     */
     func merge(with object: Self) throws -> Self {
         var updated = try mergeParse(with: object)
         if updated.shouldRestoreKey(\.customKey,
@@ -80,7 +83,10 @@ struct GameScore: ParseObject {
     //: Your own properties.
     var points: Int? = 0
 
-    //: Implement your own version of merge
+    /*:
+     Optional - implement your own version of merge
+     for faster decoding after updating your `ParseObject`.
+     */
     func merge(with object: Self) throws -> Self {
         var updated = try mergeParse(with: object)
         if updated.shouldRestoreKey(\.points,
@@ -112,9 +118,10 @@ do {
     print("Error logging out: \(error)")
 }
 
-/*: Login - asynchronously - Performs work on background
-    queue and returns to specified callbackQueue.
-    If no callbackQueue is specified it returns to main queue.
+/*:
+ Login - asynchronously - Performs work on background
+ queue and returns to specified callbackQueue.
+ If no callbackQueue is specified it returns to main queue.
 */
 User.login(username: "hello", password: "world") { result in
 
@@ -133,17 +140,21 @@ User.login(username: "hello", password: "world") { result in
     }
 }
 
-/*: Save your first `customKey` value to your `ParseUser`
-    Asynchrounously - Performs work on background
-    queue and returns to specified callbackQueue.
-    If no callbackQueue is specified it returns to main queue.
-    Using `.mergeable` allows you to only send the updated keys to the
-    parse server as opposed to the whole object.
+/*:
+ Save your first `customKey` value to your `ParseUser`
+ Asynchrounously - Performs work on background
+ queue and returns to specified callbackQueue.
+ If no callbackQueue is specified it returns to main queue.
+ Using `.mergeable` or `set()` allows you to only send
+ the updated keys to the parse server as opposed to the
+ whole object. You can chain set calls or even use
+ `set()` in combination with mutating the `ParseObject`
+ directly.
 */
-var currentUser = User.current?.mergeable
-currentUser?.customKey = "myCustom"
-currentUser?.gameScore = GameScore(points: 12)
-currentUser?.targetScore = GameScore(points: 100)
+var currentUser = User.current?
+    .set(\.customKey, to: "myCustom")
+    .set(\.gameScore, to: GameScore(points: 12))
+    .set(\.targetScore, to: GameScore(points: 100))
 currentUser?.allScores = [GameScore(points: 5), GameScore(points: 8)]
 currentUser?.save { result in
 

ParseSwift.playground/Pages/5 - ACL.xcplaygroundpage/Contents.swift

@@ -34,7 +34,10 @@ struct GameScore: ParseObject {
     //: Your own properties
     var points: Int?
 
-    //: Implement your own version of merge
+    /*:
+     Optional - implement your own version of merge
+     for faster decoding after updating your `ParseObject`.
+     */
     func merge(with object: Self) throws -> Self {
         var updated = try mergeParse(with: object)
         if updated.shouldRestoreKey(\.points,

ParseSwift.playground/Pages/6 - Installation.xcplaygroundpage/Contents.swift

@@ -37,7 +37,10 @@ struct Installation: ParseInstallation {
     //: Your custom keys
     var customKey: String?
 
-    //: Implement your own version of merge
+    /*:
+     Optional - implement your own version of merge
+     for faster decoding after updating your `ParseObject`.
+     */
     func merge(with object: Self) throws -> Self {
         var updated = try mergeParse(with: object)
         if updated.shouldRestoreKey(\.customKey,
@@ -65,10 +68,13 @@ currentInstallation?.save { results in
     }
 }
 
-/*: Update your `ParseInstallation` `customKey` and `channels` values.
-    Performs work on background queue and returns to designated on
-    designated callbackQueue. If no callbackQueue is specified it
-    returns to main queue.
+/*:
+ Update your `ParseInstallation` `customKey` and `channels` values.
+ Performs work on background queue and returns to designated on
+ designated callbackQueue. If no callbackQueue is specified it
+ returns to main queue. Using `.mergeable` or `set()`
+ allows you to only send the updated keys to the
+ parse server as opposed to the whole object.
  */
 var installationToUpdate = Installation.current?.mergeable
 installationToUpdate?.customKey = "myCustomInstallationKey2"

ParseSwift.playground/Pages/7 - GeoPoint.xcplaygroundpage/Contents.swift

@@ -26,7 +26,10 @@ struct GameScore: ParseObject {
     //: Your own properties
     var points: Int?
 
-    //: Implement your own version of merge
+    /*:
+     Optional - implement your own version of merge
+     for faster decoding after updating your `ParseObject`.
+     */
     func merge(with object: Self) throws -> Self {
         var updated = try mergeParse(with: object)
         if updated.shouldRestoreKey(\.points,