Style Guide - Editing Labs, Imaging and Procedures

Appendicitis - Labs, Imaging, and Procedures (LIP) section. The audience for this section is medical students learning what to order next. Labs, imaging, and procedures in this section relate to the primary disease topic (appendicitis in this example). Each entry requires a text tip, with an optional emoji tip. In addition to imaging, labs can be added, like D-Dimer for PE. The entries are ordered by priority, with the first entry focused on the most common item to order next. Editing the LIP section for 10,000 primary disease topics is the focus of the November 2022 sprint.

Instructions

Follow the rules in this style guide to achieve > 80% acceptance rates on your edits. 

LIP = labs, imaging, and procedures

Objectives

1. Your audience is medical students.
2. Labs, imaging, and procedures and tips should relate to diagnosing the primary disease topic.

Checklist

Is the existing list of labs, imaging and procedures complete?

1. Add missing labs, imaging, and procedures that relate to the primary disease topic and how to distinguish it from other items in the Ddx.
2. Remove unrelated labs, imaging, and procedures.

Are the labs, imaging, and procedures ordered by priority?

1. First item - overall best first item to order - for a medical student to recommend to their team. Start your free text tip with "start here" (lowercase). Also use the "start here" emoji tip 📌 in addition to the free text tip.
2. Second item - preferred in children, if applicable
3. Third item - preferred in renal failure, if applicable

Do all Procedure tips have a text tip?

Every procedure tip must include a properly formed text tip.

Do all Procedure tips start with an allowed phrase?

All Tips under "Labs, Imaging, and Procedures" must start with one of these phrases. See examples below each phrase.

1. "start here"
   1. "start here 📌"
2. "if"
   1. "if concern for associated neck abscess"
3. "to"
   1. "to quickly assess for SBO. not good for appendicitis"
4. "for"
   1. "for bx of US-visible or non-calcified mass. easier for patient than stereo bx"
5. "include"
   1. "include PROPELLER/BLADE DWI"
6. "alternative to <procedure name>"
   1. alternative to CT Sinus w - preferred in renal failure
7. "preferred in"
   1. "preferred in children 🐣"
8. "useful in resource-limited settings
   1. "useful in resource-limited settings 🍁"

Are the Tips complete and correctly formatted?

1. Start every tip with lowercase.
2. Every lab, imaging procedure, or procedure should have a free-text tip
3. Every tip should indicate when a procedure is used
4. Optionally, if relevant, include protocol information like "include PROPELLER/BLADE DWI"
5. Each tip should be written as a short phrase, not complete sentences
6. Each tip should be lowercase, except for acronyms
7. No tip should include only emoji tips - always include some text
8. Ok to repeat the emoji text in free text, for example writing “preferred in children” before the child emoji
9. No tip should end in a period ( . ) since tips are phrases and not full sentences.

What information should not to be included in labs, imaging and procedure tips?

1. Information about imaging features in specific diseases, eg.) >3 mm thickened wall.  This information should go in the Ddx tips.
2. Expanded names for acronyms, eg.) diffusion-weighted imaging should be written as DWI

Questions? [e-mail]

Epiploic appendagitis - Labs, Imaging, and Procedures section. In this finalized section, tip text follows this Style Guide. All entries have text tips, and some have emoji tips. All tips are lowercase phrases without a period at the end, not full sentences. The procedure "XR Abdomen" is not listed at all for this disease entity, which is fine, and optional.