#262: Moved action examples out of table and added json examples of each type.

Author: brynrhodes

docs/specification/1.0.md

@@ -409,7 +409,45 @@ Field | Optionality | Type | Description
 ----- | ----- | ----- | --------
 `type` |  REQUIRED | *string* | The type of action being performed. Allowed values are: `create`, `update`, `delete`.
 `description` | REQUIRED | *string* | Human-readable description of the suggested action MAY be presented to the end-user.
-`resource` | OPTIONAL | *object* | Depending upon the `type` attribute, a new resource or the id of a resource. When the `type` attribute is `create`, the `resource` attribute contains a new FHIR resource to be created (e.g. for `medication-prescribe`, this holds the updated prescription as proposed by the suggestion).  For `delete`, this is the id of any resource to remove (e.g. for the `order-review` hook, this would provide a way to remove an order from the pending list). In hooks like `medication-prescribe` where only one "content" resource is ever relevant, this field MAY be omitted for deletes only. For `update`, this holds the updated resource (e.g. for the `order-review` hook, this would provide a way to annotate an order from the pending list with an assessment).
+`resource` | OPTIONAL | *object* | Depending upon the `type` attribute, a new resource or the id of a resource. When the `type` attribute is `create`, the `resource` attribute contains a new FHIR resource to be created. For `delete`, this is the id of the resource to remove. In hooks where only one "content" resource is ever relevant, this attribute MAY be omitted for deletes only. For `update`, this holds the updated resource.
+
+The following example illustrates a create action:
+
+```json
+{
+	"type": "create",
+	"description": "Create a prescription for Acetaminophen 250 MG",
+	"resource": {
+		"resourceType": "MedicationRequest",
+		"id": "medrx001",
+		"...": "<snipped for brevity>"
+	}
+}
+```
+
+The following example illustrates an update action:
+
+```json
+{
+	"type": "update",
+	"description": "Update the order to record the appropriateness score",
+	"resource": {
+		"resourceType": "ProcedureRequest",
+		"id": "procedure-request-1",
+		"...": "<snipped for brevity"
+	}
+}
+```
+
+The following example illustrates a delete action:
+
+```json
+{
+	"type": "delete",
+	"description": "Remove the inappropriate order",
+	"resource": "ProcedureRequest/procedure-request-1"
+}
+```
 
 #### Link