logicahealth / vha-kbs-knarts

VHA Knowledge-Based Systems clinical knowledge artifact content development program.
Apache License 2.0
7 stars 3 forks source link

Missing description in CDS Connect artifact #479

Open ssebast2 opened 5 years ago

ssebast2 commented 5 years ago

I noticed that the following multimodal artifact does not include a description (https://cds.ahrq.gov/cdsconnect/artifact/neurology-traumatic-brain-injury-tbi).

If you would like to develop a description, I would be happy to copy/paste it in to the artifact.

Thanks!

preston commented 5 years ago

@linophth Would you like to provide descriptions for the composites? IIRC this is an issue that came up during content development, and ultimately not of them were populated.

ssebast2 commented 5 years ago

Thanks Preston and Linda.

There are only two multimodal artifacts that don't include descriptions - the TBI one and the hypoglycemia one. https://cds.ahrq.gov/cdsconnect/artifact/endocrinology-hypoglycemia https://cds.ahrq.gov/cdsconnect/artifact/neurology-traumatic-brain-injury-tbi

linophth commented 5 years ago

I will be happy to create descriptions for hypoglycemia and TBI. Will you help me a little by reminding me where in the XML the descriptions are located? It has been awhile, and I would like to review descriptions from earlier artifacts to remind myself how we framed them. Right now I can't find them!

ssebast2 commented 5 years ago

Thanks @linophth - The XML zipfiles for the 2 artifacts are uploaded in the Technical File section of each of the artifacts accessible via the hyperlinks above.

linophth commented 5 years ago

I don't have any trouble finding the artifacts. As soon as somebody reminds me where in the XML artifacts to look for the descriptions then I can very quickly provide you what you need for hypoglycemia and TBI.

preston commented 5 years ago

@linophth Sorry for the delay, I've been absorbed in related projects. :( In KNART XML, there should always be a "description" element below (or near) the title element. For example: https://github.com/OSEHRA/vha-kbs-knarts/blob/daa237f0c1feaf7f5611d98bf76c38ed0086b8aa/content/endocrinology_hypoglycemia/b33/CDSK_KRprt_OS_B33Hypogly.xml#L25

IIRC I had done an en masse change to add this element in cases where they it was missing, but looks like some fell through the cracks. After it's changed, the various metadata files need to be updated .. I usually do that.

linophth commented 5 years ago

Hi Lee,

See my earlier email. Neither hypoglycemia nor TBI include a composite artifact, so what artifacts are we talking about that need descriptions?

Linda Wedemeyer, MD, RN, MS Physician Informatician, Clinical Decision Support Clinical Informatics and Data Management Office (CIDMO) Mobile 323-422-2113 Los Angeles, CA

From: Preston Lee notifications@github.com Sent: Friday, April 19, 2019 2:49 PM To: OSEHRA/vha-kbs-knarts vha-kbs-knarts@noreply.github.com Cc: Wedemeyer, Linda Linda.Wedemeyer@va.gov; Mention mention@noreply.github.com Subject: [EXTERNAL] Re: [OSEHRA/vha-kbs-knarts] Missing description in CDS Connect artifact (#479)

@linophthhttps://github.com/linophth Sorry for the delay, I've been absorbed in related projects. :( In KNART XML, there should always be a "description" element below (or near) the title element. For example: https://github.com/OSEHRA/vha-kbs-knarts/blob/daa237f0c1feaf7f5611d98bf76c38ed0086b8aa/content/endocrinology_hypoglycemia/b33/CDSK_KRprt_OS_B33Hypogly.xml#L25

IIRC I had done an en masse change to add this element in cases where they it was missing, but looks like some fell through the cracks. After it's changed, the various metadata files need to be updated .. I usually do that.

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHubhttps://github.com/OSEHRA/vha-kbs-knarts/issues/479#issuecomment-485022387, or mute the threadhttps://github.com/notifications/unsubscribe-auth/AJEGBVOEX6DLMENIDFYMAP3PRI425ANCNFSM4HESS5MQ.

ssebast2 commented 5 years ago

@linophth , it is my understanding that the multi-modal artifacts represent the super set of "sub-artifacts" within that white paper. If an implementer chose to do so, they might implement all of the CDS expressions outlined in the white paper (e.g., the hypoglycemia order set, rule and documentation template), therefore the multi-modal artifact.

Some of the VHA multi-modal artifacts include descriptions (see https://cds.ahrq.gov/cdsconnect/artifact/mental-health-consult-depression), only 2 do not (the hypoglycemia and the TBI ones).

It would be nice to have at least 1 sentence explaining what the hypoglycemia and TBI multi-modal artifacts are.

linophth commented 5 years ago

The mental health depression consult includes a composite knowledge artifact designed to coordinate the activity of other artifacts (e.g. order set and documentation template), in this case in the context of a consult request to mental health for depression. Not all white papers include composite knowledge artifacts, which is what we have been calling them. The only overarching artifact artifact when there is no composite knowledge artifact is the white paper, and I did not create descriptions for any of the white papers. I think we need Preston's input here.

ssebast2 commented 5 years ago

@preston @linophth Thank you for clarifying that not all white papers include composite knowledge artifacts. Based on the list of artifacts available here: http://vha-kbs-knarts.healthcreek.org/, it seems that the two artifacts that I am concerned about are composite artifacts. Table of Contents Composites Cardiology: Electrophysiology Consult Mental Health: Consult for Depression Diagnostic Breast Imaging Consult Request/Composite Cardiology: Pre-Op Risk Assessment Composite Endocrinology: Hypoglycemia Neurosurgery Radiculopathy (Lumbar Thoracic) Rheumatology: Rheumatoid Arthritis GI: Colonoscopy Hepatitis C Neurosurgery Radiculopathy (Cervical) Neurology: Traumatic Brain Injury (TBI) Cardiology: Chest Pain (CP) / Coronary Artery Disease (CAD)

I think it would be helpful to have a very brief description for Repository viewers to understand what they are viewing when they open the artifact, in order to provide context for the remainder of the information. If it is not feasible to create a 1-2 sentence description, we can leave the artifacts as is.

Thanks for your review and consideration of this feedback

linophth commented 5 years ago

I have no idea what artifacts you are talking about that need descriptions, because neither the TBI nor the hypoglycemia artifacts include composites. Here are the TBI KNARTS: Neurology KNART

Associated CLIN

Traumatic Brain Injury (TBI) Screening – Event Condition Action (ECA) Rule

CLIN0003AA

Traumatic Brain Injury (TBI) Screening - Documentation Template

CLIN0005AB

Traumatic Brain Injury (TBI) Screening - Documentation Template/Consult Request

CLIN0005AB

Traumatic Brain Injury (TBI) Polytrauma Interdisciplinary Rehabilitation Clinic - Order Set

CLIN0004AA

Traumatic Brain Injury (TBI) Polytrauma Concussion - Order Set

CLIN0004AA

Traumatic Brain Injury (TBI) Rehabilitation Medicine Spasticity Clinic - Order Set

CLIN0004AA

Traumatic Brain Injury (TBI) Screening - Composite/Consult Request

N/A

Here are the hypoglycemia KNARTS: Hypoglycemia KNART

Associated CLIN

Hypoglycemia – Event Condition Action (ECA) Rule

CLIN0003AA

Hypoglycemia – Order Set

CLIN0004AB

Hypoglycemia – Documentation Template

CLIN0005AB

Linda Wedemeyer, MD, RN, MS Physician Informatician, Clinical Decision Support Clinical Informatics and Data Management Office (CIDMO) Mobile 323-422-2113 Los Angeles, CA

From: ssebast2 notifications@github.com Sent: Tuesday, April 30, 2019 7:50 AM To: OSEHRA/vha-kbs-knarts vha-kbs-knarts@noreply.github.com Cc: Wedemeyer, Linda Linda.Wedemeyer@va.gov; Mention mention@noreply.github.com Subject: [EXTERNAL] Re: [OSEHRA/vha-kbs-knarts] Missing description in CDS Connect artifact (#479)

@prestonhttps://github.com/preston @linophthhttps://github.com/linophth Thank you for clarifying that not all white papers include composite knowledge artifacts. Based on the list of artifacts available here: http://vha-kbs-knarts.healthcreek.org/, it seems that the two artifacts that I am concerned about are composite artifacts. Table of Contents Composites Cardiology: Electrophysiology Consult Mental Health: Consult for Depression Diagnostic Breast Imaging Consult Request/Composite Cardiology: Pre-Op Risk Assessment Composite Endocrinology: Hypoglycemia Neurosurgery Radiculopathy (Lumbar Thoracic) Rheumatology: Rheumatoid Arthritis GI: Colonoscopy Hepatitis C Neurosurgery Radiculopathy (Cervical) Neurology: Traumatic Brain Injury (TBI) Cardiology: Chest Pain (CP) / Coronary Artery Disease (CAD)

I think it would be helpful to have a very brief description for Repository viewers to understand what they are viewing when they open the artifact, in order to provide context for the remainder of the information. If it is not feasible to create a 1-2 sentence description, we can leave the artifacts as is.

Thanks for your review and consideration of this feedback

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHubhttps://github.com/OSEHRA/vha-kbs-knarts/issues/479#issuecomment-487982860, or mute the threadhttps://github.com/notifications/unsubscribe-auth/AJEGBVLMM7M5M4HRZPY4UDDPTBMBXANCNFSM4HESS5MQ.

ssebast2 commented 5 years ago

@linophth, @preston The Hypoglycemia artifact was uploaded to the Repository as a Composite artifact. https://cds.ahrq.gov/cdsconnect/artifact/endocrinology-hypoglycemia (see the XML file attachment named "Composite Artifact"). The same is true for the TBI multi-modal artifact (https://cds.ahrq.gov/cdsconnect/artifact/neurology-traumatic-brain-injury-tbi).

It might be best as this point to leave things as is, but moving forward, we will adjust how we approach multi-modal artifacts.

Thanks for your engagement on this concern.

linophth commented 5 years ago

Preston can you explain this? There is no composite artifact for hypoglycemia.

From: ssebast2 notifications@github.com Sent: Tuesday, April 30, 2019 1:11 PM To: OSEHRA/vha-kbs-knarts vha-kbs-knarts@noreply.github.com Cc: Wedemeyer, Linda Linda.Wedemeyer@va.gov; Mention mention@noreply.github.com Subject: [EXTERNAL] Re: [OSEHRA/vha-kbs-knarts] Missing description in CDS Connect artifact (#479)

@linophthhttps://github.com/linophth, @prestonhttps://github.com/preston The Hypoglycemia artifact was uploaded to the Repository as a Composite artifact. https://cds.ahrq.gov/cdsconnect/artifact/endocrinology-hypoglycemia (see the XML file attachment named "Composite Artifact"). The same is true for the TBI multi-modal artifact (https://cds.ahrq.gov/cdsconnect/artifact/neurology-traumatic-brain-injury-tbi).

It might be best as this point to leave things as is, but moving forward, we will adjust how we approach multi-modal artifacts.

Thanks for your engagement on this concern.

— You are receiving this because you were mentioned. Reply to this email directly, view it on GitHubhttps://github.com/OSEHRA/vha-kbs-knarts/issues/479#issuecomment-488097443, or mute the threadhttps://github.com/notifications/unsubscribe-auth/AJEGBVLTU5QU3YWZDUOU3TDPTCRVLANCNFSM4HESS5MQ.