Add update section

Author: Baltazore

app/routes/application.js

@@ -28,6 +28,21 @@ export default class ApplicationRoute extends Route {
           },
         ],
       },
+      {
+        id: 'updating-data',
+        subsections: [
+          {
+            id: 'create-record',
+            classicFiles: ['old.js'],
+            octaneFiles: ['new.js'],
+          },
+          {
+            id: 'save-record',
+            classicFiles: ['old.js'],
+            octaneFiles: ['new.js'],
+          },
+        ],
+      },
       {
         id: 'adapters',
         subsections: [

snippets/updating-data/create-record/new.js

@@ -0,0 +1,13 @@
+import { recordIdentifierFor } from '@ember-data/store';
+import { createRecord, serializeResources } from '@ember-data/json-api/request';
+
+const record = store.createRecord('user', {});
+const request = createRecord(record);
+request.body = JSON.stringify(
+  serializeResources(
+    store.cache,
+    recordIdentifierFor(record)
+  )
+);
+
+await store.request(request);

snippets/updating-data/create-record/old.js

@@ -0,0 +1,2 @@
+const record = this.store.createRecord('user', { name: "Chris" });
+await record.save();

snippets/updating-data/save-record/new.js

@@ -0,0 +1,14 @@
+import { recordIdentifierFor } from '@ember-data/store';
+import { updateRecord, serializePatch } from '@ember-data/json-api/request';
+
+user.name = 'Chris';
+
+const request = updateRecord(user);
+request.body = JSON.stringify(
+  serializePatch(
+    store.cache,
+    recordIdentifierFor(user)
+  )
+);
+
+await store.request(request);

snippets/updating-data/save-record/old.js

@@ -0,0 +1,4 @@
+const user = this.store.peekRecord('user', '1');
+
+user.name = 'Chris';
+await user.save();

translations/updating-data/create-record/en-us.yaml

@@ -0,0 +1,2 @@
+title: createRecord
+description: To create a new record using Ember Data you should use <code>createRecord</code> request and attach <code>"body"</code> to it. In case of JSON:API backend - you can user <code>serializeResources</code> request utility.

translations/updating-data/en-us.yaml

@@ -0,0 +1,7 @@
+title: Creating/Updating Data
+description: >
+  For requests that are expected to send a "body" to the API applications may choose to either serialize the body at the point of the request or to implement a Handler for the RequestManager to do so.
+
+  EmberData does not provide a default handler which serializes because this is a unique concern for every app. However, EmberData does provide utilities on both the Cache and for some of the builders to make this easy.
+
+  For JSON:API we show the "at point of request" approach using the utils provided by the @ember-data/json-api package here.

translations/updating-data/general/en-us.yaml

@@ -0,0 +1,7 @@
+title: General concepts / philosophy
+description: >
+  For requests that are expected to send a <code>"body"</code> to the API applications may choose to either serialize the body at the point of the request or to implement a <code>Handler</code> for the <code>RequestManager</code> to do so.
+
+  Ember Data does not provide a default handler which serializes because this is a unique concern for every app. However, Ember Data does provide utilities on both the <code>Cache</code> and for some of the <code>builders</code> to make this easy.
+
+  For <code>JSON:API</code> we show the "at point of request" approach using the utils provided by the <code>@ember-data/json-api</code> package here.

translations/updating-data/save-record/en-us.yaml

@@ -0,0 +1,2 @@
+title: saveRecord / updateRecord
+description: To update record, you should send <code>updateRecord</code> request to your backend and attach <code>"body"</code> to it. Based on your backend server needs, you can use <code>serializeResources</code> or <code>serializePatch</code> request utilities.