Merge branch 'master' into iss308-fix-link-to-MedRequest

Author: kpshek

docs/hooks/medication-prescribe.md

@@ -11,13 +11,13 @@ The user is in the process of prescribing one or more new medications.
 
 ## Context
 
-The set of medications proposed or in progress of being prescribed. All FHIR resources in this context MUST be based on the same FHIR version.
+The set of medications proposed or in progress of being prescribed. All FHIR resources in this context MUST be based on the same FHIR version. All FHIR resources in the medications object MUST have a status of _draft_.
 
 Field | Optionality | Prefetch Token | Type | Description
 ----- | -------- | ---- | ---- | ----
 `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
-`medications` | REQUIRED | No | *object* | DSTU2 - FHIR Bundle of MedicationOrder resources <br/> STU3 - FHIR Bundle of MedicationOrder
+`medications` | REQUIRED | No | *object* | DSTU2 - FHIR Bundle of _draft_ MedicationOrder resources <br/> STU3 - FHIR Bundle of _draft_ MedicationRequest resources
 
 ### Example (DSTU2)
 

docs/hooks/order-review.md

@@ -11,13 +11,13 @@ The user is in the process of reviewing a set of orders to sign.
 
 ## Context
 
-The set of orders being reviewed for signature on-screen. All FHIR resources in this _context_ MUST be based on the same FHIR version.
+The set of orders being reviewed for signature on-screen. All FHIR resources in this _context_ MUST be based on the same FHIR version. All FHIR resources in the medications object MUST have a status of _draft_.
 
 Field | Optionality | Prefetch Token | Type | Description
 ----- | -------- | ---- | ---- | ----
 `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
-`orders` | REQUIRED | No | *object* | DSTU2 - FHIR Bundle of MedicationOrder, DiagnosticOrder, DeviceUseRequest, ReferralRequest, ProcedureRequest, NutritionOrder, VisionPrescription <br/> STU3 - FHIR Bundle of MedicationRequest, ReferralRequest, ProcedureRequest, NutritionOrder, VisionPrescription
+`orders` | 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
 
 ### Example (DSTU2)
 

docs/specification/1.0.md

@@ -25,7 +25,7 @@ CDS Hooks implementers are not required to use the Open API Specification interf
 
 ## Discovery
 
-Developers of CDS Services SHALL provide a stable endpoint for allowing EHRs to discover available CDS Services, including information such as the purpose of the CDS Service, when it should be invoked, and any data that is requested to be prefetched.
+Developers of CDS Services SHALL provide a stable endpoint for allowing EHRs to discover available CDS Services, including information such as a description of the CDS Service, when it should be invoked, and any data that is requested to be prefetched.
 
 A CDS Service provider SHALL expose its Discovery endpoint at"
 
@@ -373,19 +373,9 @@ Each **Suggestion** is described by the following attributes.
 Field | Optionality | Type | Description
 ----- | ----- | ----- | --------
 `label` | REQUIRED | *string* | Human-readable label to display for this suggestion (e.g. the EHR might render this as the text on a button tied to this suggestion).
-`uuid` | OPTIONAL | *string* | Unique identifier for this suggestion. For details see [Suggestion Tracking Analytics](#suggestion-tracking-analytics)
+`uuid` | OPTIONAL | *string* | Unique identifier, used for auditing and logging suggestions.
 `actions` | OPTIONAL | *array* | Array of objects, each defining a suggested action. Within a suggestion, all actions are logically AND'd together, such that a user selecting a suggestion selects all of the actions within it.
 
-##### Suggestion Tracking Analytics
-
-Whenever a user clicks a displayed label (e.g., button) from a "suggestion" card, the EHR uses the
-suggestion `uuid` to notify the CDS Service's analytics endpoint via a `POST`
-with an empty body:
-
-    `POST {baseUrl}/cds-services/{serviceId}/analytics/{uuid}`
-
-If a suggestion has no `uuid`, the EHR does not send a notification.
-
 ##### Action
 
 Each **Action** is described by the following attributes.