Added examples for Opioid guidelines and radiology assessment. #64

brynrhodes · 2017-07-25T23:15:39Z

Adds clinically relevant examples to address issue #32.

kpshek · 2017-07-26T07:13:09Z

@brynrhodes - Take a look at the deployed review app with your changes. There are some syntax errors that you'll need to fix.

Also, move the example above the documentation. That will allow Slate to align the example in the righthand sidebar with the documentation in the middle pane.

…les.

kpshek

Thanks @brynrhodes for adding these clinical examples / use cases! These will really help others understand more complex uses of CDS Hooks.

kpshek · 2017-07-27T02:31:28Z

source/includes/_examples.md

+          "system": "http://www.ama-assn.org/go/cpt",
+          "code": "70450",
+          "display": "CT, head, wo iv contrast"
+        }],


This json is malformed due to the trailing comma on this line: }],

Agreed and fixed.

kpshek · 2017-07-27T02:34:10Z

source/includes/_examples.md

+```json
+{
+  "hookInstance": "d1577c69-dfbe-44ad-ba6d-3e05e953b2ea",
+  "fhirServer": "http://fhirtest.uhn.ca/baseDstu2",


Rather than use a real FHIR server URL here (and below), would you rather use something like https://fhir.example.com? I know we use http://hooks.smarthealthit.org:9080 in another example in the doc but these URLs will likely become broken in the future and developers may have expectations that they can hit this URL in the example. Using the example.com domain makes it clear that these are pure examples.

Thoughts?

kpshek · 2017-07-27T02:35:31Z

source/includes/_examples.md

+      "dateWritten": "2017-05-05",
+      "status": "draft",
+      "patient": {
+        "reference": "Patient/example"


Should this match the Patient reference below (Patient/Patient-12214)?

kpshek · 2017-07-27T02:36:36Z

source/includes/_examples.md

+
+This example illustrates the use of the CDS Hooks `medication-prescribe` hook to implement Recommendation #5 from the [CDC guideline for prescribing opioids for chronic pain](https://guidelines.gov/summaries/summary/50153/cdc-guideline-for-prescribing-opioids-for-chronic-pain---united-states-2016#420).
+
+This example is taken from the [Opioid Prescribing Support Implementation Guide](http://build.fhir.org/ig/cqframework/opioid-cds/), developed in partnership with the Centers for Disease Control and Prevention [(CDC)](https://www.cdc.gov/).


Note: We'll need to change this URL off of the build domain to when we get the final published IG

kpshek · 2017-07-27T02:37:44Z

source/includes/_examples.md

@@ -0,0 +1,219 @@
+# Examples
+
+## CDC Guideline for Prescribing Opioids for Chronic Pain - Request


Nit: Maybe we should make the h2 'CDC Guideline for Prescribing Opioids for Chronic Pain' and then both Request and Response can be h3 elements?

I tried to do this, but the Slate processing didn't like it, it seemed to just ignore the h3 elements. Perhaps it was just a case of me not understanding how to express it with Slate?

I just tested both ## (h2) and ### (h3) and they work. Only # (h1) and ## headers will show in the left hand sidebar. h3 headers do show in the middle documentation panel.

kpshek · 2017-07-27T02:38:45Z

source/includes/_examples.md

+
+The opioid guideline request results in the following response that indicates the patient is at high risk for opioid overdose according to the CDC guidelines, and the dosage should be tapered to less than 50 MME. Links are provided to the guideline, as well as to the MME conversion tables provided by CDC.
+
+## Radiology Appropriateness - Request


Same nit comment as above with the headings

kpshek · 2017-07-27T02:39:33Z

source/includes/_examples.md

+{
+  "hookInstance": "d1577c69-dfbe-44ad-ba6d-3e05e953b2ea",
+  "fhirServer": "http://fhirtest.uhn.ca/baseDstu2",
+  "hook": "medication-prescribe",


Below you say this is using the order-review hook

Agreed and fixed.

…s/docs into iss32-clinical-examples

brynrhodes · 2017-07-27T17:49:23Z

I added sub-headers for the request and response, but they don't line up with the code snippets, so it's a little confusing. Happy to go with the sub-headers though.

isaacvetter

@kpshek - can you rereview and approve?

Added examples for Opioid guidelines and radiology assessment.

d9f0968

brynrhodes requested review from kpshek and isaacvetter July 25, 2017 23:15

Merge branch 'master' into iss32-clinical-examples

728a1ac

kpshek temporarily deployed to cds-hooks-docs-pr-64 July 26, 2017 07:06 Inactive

Merge branch 'master' into iss32-clinical-examples

3970670

kpshek temporarily deployed to cds-hooks-docs-pr-64 July 26, 2017 07:37 Inactive

Fixed syntax errors and corrected documentation positioning for examp…

18d4698

…les.

kpshek temporarily deployed to cds-hooks-docs-pr-64 July 26, 2017 15:20 Inactive

Added headers to separate request/response examples.

7ad4f74

kpshek temporarily deployed to cds-hooks-docs-pr-64 July 26, 2017 15:25 Inactive

Fixing example headers.

14b1420

kpshek temporarily deployed to cds-hooks-docs-pr-64 July 26, 2017 15:34 Inactive

Merge branch 'master' into iss32-clinical-examples

065ba00

kpshek temporarily deployed to cds-hooks-docs-pr-64 July 27, 2017 02:27 Inactive

kpshek suggested changes Jul 27, 2017

View reviewed changes

brynrhodes added 2 commits July 27, 2017 09:44

Fixed URLs and patient references plus a JSON syntax error.

c57b56b

Merge branch 'iss32-clinical-examples' of https://github.com/cds-hook…

228e5fa

…s/docs into iss32-clinical-examples

kpshek temporarily deployed to cds-hooks-docs-pr-64 July 27, 2017 15:45 Inactive

Added sub-headers

6d8e773

kpshek temporarily deployed to cds-hooks-docs-pr-64 July 27, 2017 17:45 Inactive

isaacvetter approved these changes Aug 4, 2017

View reviewed changes

isaacvetter mentioned this pull request Aug 4, 2017

Provide a consistent structure for top-level feedback, suggestions, and decisions #48

Closed

kpshek temporarily deployed to cds-hooks-docs-pr-64 August 4, 2017 20:54 Inactive

Move headings back to the code example section as it looked awkward.

327bb87

kpshek temporarily deployed to cds-hooks-docs-pr-64 August 10, 2017 15:55 Inactive

Fix typo

4cc7587

kpshek approved these changes Aug 10, 2017

View reviewed changes

kpshek deployed to cds-hooks-docs-pr-64 August 10, 2017 15:58 View deployment

kpshek merged commit 27e75b2 into master Aug 10, 2017

kpshek deleted the iss32-clinical-examples branch August 10, 2017 16:02

robs16 mentioned this pull request Sep 9, 2017

Decisions without interaction #85

Closed

isaacvetter mentioned this pull request May 14, 2018

Flesh out a guideline appropriate ordering scoring data flow #13

Open

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Added examples for Opioid guidelines and radiology assessment. #64

Added examples for Opioid guidelines and radiology assessment. #64

brynrhodes commented Jul 25, 2017

kpshek commented Jul 26, 2017

kpshek left a comment

kpshek Jul 27, 2017

brynrhodes Jul 27, 2017

kpshek Jul 27, 2017

brynrhodes Jul 27, 2017

kpshek Jul 27, 2017

kpshek Jul 27, 2017

brynrhodes Jul 27, 2017

kpshek Jul 27, 2017

brynrhodes Jul 27, 2017

kpshek Jul 27, 2017

kpshek Jul 27, 2017

kpshek Jul 27, 2017

brynrhodes Jul 27, 2017

brynrhodes commented Jul 27, 2017

isaacvetter left a comment


		This example illustrates the use of the CDS Hooks `medication-prescribe` hook to implement Recommendation #5 from the [CDC guideline for prescribing opioids for chronic pain](https://guidelines.gov/summaries/summary/50153/cdc-guideline-for-prescribing-opioids-for-chronic-pain---united-states-2016#420).

		This example is taken from the [Opioid Prescribing Support Implementation Guide](http://build.fhir.org/ig/cqframework/opioid-cds/), developed in partnership with the Centers for Disease Control and Prevention [(CDC)](https://www.cdc.gov/).

		@@ -0,0 +1,219 @@
		# Examples

		## CDC Guideline for Prescribing Opioids for Chronic Pain - Request


		The opioid guideline request results in the following response that indicates the patient is at high risk for opioid overdose according to the CDC guidelines, and the dosage should be tapered to less than 50 MME. Links are provided to the guideline, as well as to the MME conversion tables provided by CDC.

		## Radiology Appropriateness - Request

Added examples for Opioid guidelines and radiology assessment. #64

Added examples for Opioid guidelines and radiology assessment. #64

Conversation

brynrhodes commented Jul 25, 2017

kpshek commented Jul 26, 2017

kpshek left a comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

Choose a reason for hiding this comment

brynrhodes commented Jul 27, 2017

isaacvetter left a comment

Choose a reason for hiding this comment