Add documentation for mutation without relay

Resources/doc/definitions/index.md

@@ -7,6 +7,7 @@ Definitions
 Go further 
 ----------
 
+* [Mutation](mutation.md)
 * [Relay](relay/index.md)
 * [Builders](builders/index.md)
 * [Expression language](expression-language.md)

Resources/doc/definitions/mutation.md

@@ -0,0 +1,37 @@
+# Mutation
+
+Here an example without using relay:
+
+```yaml
+Mutation:
+    type: object
+    config:
+        fields:
+            IntroduceShip:
+                type: IntroduceShipPayload!
+                resolve: "@=mutation('create_ship', [args['input']['shipName'], args['input']['factionId']])"
+                args:
+                    #using input object type is optionnal, we use it here to be iso with relay mutation example.
+                    input:
+                        type: IntroduceShipInput!
+
+IntroduceShipPayload:
+    type: object
+    config:
+        fields:
+            ship:
+                type: "Ship"
+            faction:
+                type: "Faction"
+
+IntroduceShipInput:
+    type: input-object
+    config:
+        fields:
+            shipName:
+                type: "String!"
+            factionId:
+                type: "String!"
+```
+
+Here the same example [using relay mutation](relay/mutation.md).

Resources/doc/definitions/relay/mutation.md

@@ -2,43 +2,44 @@ Mutation
 ========
 
 ```yaml
-RootMutation:
+Mutation:
     type: object
     config:
         fields:
-            simpleMutation:
+            introduceShip:
                 builder: Mutation
                 builderConfig:
-                    inputType: simpleMutationInput
-                    payloadType: simpleMutationPayload
-                    mutateAndGetPayload: "@={'result': 1}"
-            simpleMutationWithThunkFields:
-                builder: Mutation
-                builderConfig:
-                    inputType: simpleMutationWithThunkFieldsInput
-                    payloadType: simpleMutationWithThunkFieldsPayload
-                    mutateAndGetPayload: "@={'result': value['inputData'] }"
-
-simpleMutationInput:
-    type: relay-mutation-input
-    config:
-        fields: []
+                    inputType: IntroduceShipInput
+                    payloadType: IntroduceShipPayload
+                    mutateAndGetPayload: "@=mutation('create_ship', [value['shipName'], value['factionId']])"
 
-simpleMutationWithThunkFieldsInput:
+#   input IntroduceShipInput {
+#     clientMutationId: string!
+#     shipName: string!
+#     factionId: ID!
+#   }
+IntroduceShipInput:
     type: relay-mutation-input
     config:
         fields:
-            inputData : { type: "Int" }
-
-simpleMutationPayload:
-    type: relay-mutation-payload
-    config:
-        fields:
-            result: { type: "Int" }
+            shipName:
+                type: "String!"
+            factionId:
+                type: "String!"
 
-simpleMutationWithThunkFieldsPayload:
+#   type IntroduceShipPayload {
+#     clientMutationId: string!
+#     ship: Ship
+#     faction: Faction
+#   }
+IntroduceShipPayload:
     type: relay-mutation-payload
     config:
         fields:
-            result: { type: "Int" }
+            ship:
+                type: "Ship"
+            faction:
+                type: "Faction"
 ```
+
+Here the same example [without using relay mutation](../mutation.md).