Merge pull request #469 from mattvarghese/master

Deprecate medication-prescribe and order-review

Author: isaacvetter

docs/hooks/medication-prescribe.md

@@ -6,6 +6,11 @@
 | hookVersion | 1.0
 | Hook maturity | [2 - Tested](../../specification/1.0/#hook-maturity-model)
 
+
+## Deprecation Notice
+
+This hook is deprecated in favor of the `order-select` and `order-sign` hooks, with the goal of  clarifying workflow trigger points and supporting orders beyond medications. In this refactoring, `medication-prescribe` and `order-review` hooks are being deprecated in favor of newly created [`order-select`](../order-select) and [`order-sign`](../order-sign) hooks. This notice is a placeholder to this effect while CDS Hooks determines the [appropriate process for deprecating hooks](https://github.com/cds-hooks/docs/issues/433).
+
 ## Workflow
 
 The user is in the process of prescribing one or more new medications.

docs/hooks/order-review.md

@@ -6,6 +6,10 @@
 | hookVersion | 1.0
 | Hook maturity | [3 - Considered](../../specification/1.0/#hook-maturity-model)
 
+## Deprecation Notice
+
+This hook is deprecated in favor of the `order-sign` hooks, with the goal of  clarifying workflow trigger points and supporting orders beyond medications. In this refactoring, `medication-prescribe` and `order-review` hooks are being deprecated in favor of newly created [`order-select`](../order-select) and [`order-sign`](../order-sign) hooks. This notice is a placeholder to this effect while CDS Hooks determines the [appropriate process for deprecating hooks](https://github.com/cds-hooks/docs/issues/433).
+
 ## Workflow
 
 The user is in the process of reviewing a set of orders to sign.

docs/hooks/order-select.md

@@ -4,6 +4,7 @@
 | ---- | ----
 | specificationVersion | 1.0
 | hookVersion | 1.0
+| Hook maturity | [1 - Submitted](../../specification/1.0/#hook-maturity-model)
 
 ## Workflow
 
@@ -14,6 +15,8 @@ as it first occurs immediately upon the clinician selecting the order from the o
 Additionally, the context may include previously selected orders that are not yet signed from the same ordering session. 
 The `order-select` hook occurs after the clinician selects the order and before signing. 
 
+This hook is intended to replace (deprecate) the `medication-prescribe` hook. 
+
 ## Context
 
 The context of this hook distinguishes between the list of unsigned orders from the clinician's ordering session, and one or orders just added to this list. The `selections` field contains a list of ids of these newly selected orders; the `draftOrders` Bundle contains an entry for all unsigned orders from this session, including newly selected orders.
@@ -23,7 +26,7 @@ Field | Optionality | Prefetch Token | Type | Description
 `userId` | REQUIRED | Yes | *string* | The id of the current user.<br />For this hook, the user is expected to be of type [Practitioner](https://www.hl7.org/fhir/practitioner.html).<br />For example, `Practitioner/123`
 `patientId` | REQUIRED | Yes | *string* |  The FHIR `Patient.id` of the current patient in context
 `encounterId` | OPTIONAL | Yes | *string* |  The FHIR `Encounter.id` of the current encounter in context
-`selections` | REQUIRED | No| *array* | The FHIR id of the newly selected order(s).<br />The `selections` field references FHIR resources in the `orders` Bundle. For example, `MedicationRequest/103`.
+`selections` | REQUIRED | No| *array* | The FHIR id of the newly selected order(s).<br />The `selections` field references FHIR resources in the `draftOrders` Bundle. For example, `MedicationRequest/103`.
 `draftOrders` | REQUIRED | No | *object* | DSTU2 - FHIR Bundle of MedicationOrder, DiagnosticOrder, DeviceUseRequest, ReferralRequest, ProcedureRequest, NutritionOrder, VisionPrescription with _draft_ status <br/> STU3 - FHIR Bundle of MedicationRequest, ReferralRequest, ProcedureRequest, NutritionOrder, VisionPrescription with _draft_ status
 
 

docs/hooks/order-sign.md

@@ -4,7 +4,7 @@
 | ---- | ----
 | specificationVersion | 1.0
 | hookVersion | 1.0
-| Hook maturity | 1 - Submitted
+| Hook maturity | [1 - Submitted](../../specification/1.0/#hook-maturity-model)
 
 ## Workflow
 
@@ -14,7 +14,7 @@ The context contains all order details, such as dose, quantity, route, etc,
 although the order has not yet been signed and therefore still exists in a draft status. 
 Use this hook when your service requires all order details, and the clinician will accept recommended changes.
 
-This hook is intended to replace (deprecate) the `order-review` hook. 
+This hook is intended to replace (deprecate) the `medication-prescribe` and `order-review` hooks. 
 
 ## Context