Resident survival guide checklist: Difference between revisions

Jump to navigation Jump to search
Rim Halaby (talk | contribs)
No edit summary
Line 13: Line 13:
** Classification (if needed for the management)
** Classification (if needed for the management)
** Causes
** Causes
** Diagnosis
** FIRE
** Complete Diagnostic Approach
** Treatment
** Treatment
** Prophylaxis (if applicable)
** Do's
** Do's
** Dont's
** Dont's
** References
** References
* In some emergency diseases, initial therapeutic management precedes the extensive diagnostic approach.  In this case, the sequence of the headings for the diagnosis and the treatment can be altered.


* The treatment for some diseases is extensive or it can be subdivided into sections.  In this case, appropriate headings are used to organize the treatment.  Click '''[[STEMI resident survival guide|here]]''' for an example.
* The treatment for some diseases is extensive or it can be subdivided into sections.  In this case, appropriate headings are used to organize the treatment.  Click '''[[STEMI resident survival guide|here]]''' for an example.
Line 26: Line 24:
===Floating Navigation Bar===
===Floating Navigation Bar===
* A navigation bar is present on every resident survival guide page.  Click '''[[Template:Resident_survival_guide|here]]''' for a template.
* A navigation bar is present on every resident survival guide page.  Click '''[[Template:Resident_survival_guide|here]]''' for a template.
* For an example of a page with a floating navigation bar, check [[appendicitis resident survival guide]].
* For an example of a page with a floating navigation bar, check [[STEMI resident survival guide]].
* The navigation bar should contain the following items: overview, causes, diagnosis, treatment, do's and don'ts.  However, the content of the navigation bar is flexible.
* The navigation bar should contain the following items: overview, classification (if applicable), causes, FIRE, complete diagnostic approach, treatment, do's and don'ts.  However, the content of the navigation bar is flexible.
** If the condition is life threatening, and the initial therapy begins before an extensive diagnostic approach, you can reorder the items in the navigation bar.
** If you have added an additional title or subtitle on your page make sure to add it in the navigation bar.
** If you have added an additional title on your page, for example classification, make sure to add it in the navigation bar.
** If the therapy is divided into several sections, modify the content of the navigation bar to fit the order of the titles of the resident survival page. Click '''[[STEMI resident survival guide|here]]''' for an example.
** If the therapy is divided into several sections, modify the content of the navigation bar to fit the order of the titles of the resident survival page. Click '''[[STEMI resident survival guide|here]]''' for an example.


Line 39: Line 36:
===Classification===
===Classification===
* The classification section should be included only when the classification of the disease is needed for the management plan.
* The classification section should be included only when the classification of the disease is needed for the management plan.
* This section provides a list of subheadings of categories with content that the disease can be classified under.
* This section provides either a table or a list of subheadings of categories with content that the disease can be classified under.
* To see an example of a classification section on the resident survival guide, click '''[[Atrial fibrillation resident survival guide|here]]'''.
* To see an example of a classification section on the resident survival guide, click '''[[Atrial fibrillation resident survival guide|here]]'''.


Line 52: Line 49:
* The causes are all hyperlinked.
* The causes are all hyperlinked.


===Diagnosis===
===FIRE===
* The diagnosis section contains the diagnostic algorithm(s).
 
* The number of algorithms depends on each topic.
===Complete Diagnostic Approach===
** If the diagnostic approach is very big and the algorithm is complicated, the algorithm is divided into more than one.
* The complete diagnostic approach section contains the diagnostic algorithm(s).
* If the diagnostic approach is very big and the algorithm is complicated, the algorithm is divided into more than one.
* If more than one algorithm is provided, a subtitle is given for each.
* If more than one algorithm is provided, a subtitle is given for each.
* When more than one algorithm are provided, separate them with <nowiki><br></nowiki>.
* When more than one algorithm are provided, separate them with <nowiki><br></nowiki>.
Line 72: Line 70:
* If more than one algorithm is provided, a subtitle is given for each.
* If more than one algorithm is provided, a subtitle is given for each.
* When more than one algorithm are provided, they are separated with <nowiki><br></nowiki>.
* When more than one algorithm are provided, they are separated with <nowiki><br></nowiki>.
* Details about the dosage, route and frequency of the medications are provided.
* Details about the dosage, route, and frequency of the medications are provided.
* Major contraindications for the medications are provided in red.  Click '''[[STEMI resident survival guide|here]]''' for an example.
* Major contraindications for the medications are provided in red.  Click '''[[STEMI resident survival guide|here]]''' for an example.
* Action verbs are used before medications or treatment, for example: "Administer aspirin" instead of aspirin.
* Action verbs are used before medications or treatment, for example: "Administer aspirin" instead of aspirin.
Line 129: Line 127:


===General Notes===
===General Notes===
* When more that one associate editors are includes, separate the names by a a semicolon followed by a space.
* When more that one associate editors are included, separate the names by a a semicolon followed by a space.
* Provide synonyms and keywords on the top of each page.
* Expand buttons should be avoided as much as possible.
* Expand buttons should be avoided as much as possible.
* Hyperlinks through <nowiki> [[ ]] </nowiki> are used to link key words to their pages.
* Hyperlinks through <nowiki> [[ ]] </nowiki> are used to link key words to their pages.
* The page should be reviewed for typographical errors and capitalization.
* The page should be reviewed for typographical errors and capitalization.
* Add '''categories''' for each section. Make sure that <nowiki>[[category:Resident survival guide]]</nowiki> is present among others, for example: <nowiki>[[Category:Cardiology]]</nowiki>.
* Add '''categories''' for each section. Make sure that <nowiki>[[category:Resident survival guide]]</nowiki> is present among others, for example: <nowiki>[[Category:Cardiology]]</nowiki>.
* Make sure that a siren is present on the main page of each of the resident survival guide's topics.
* Make sure that a siren is present on all the pages of each of the resident survival guide's topics.
* Contributors who are not native English speaking and require help in writing should add the Category:Grammar to their pages.
* Contributors who are not native English speakers and require help in writing should add the Category:Grammar to their pages.
* In Category: Grammar is added on the pages of contributors who are not native English speaking and require help in writing.


===Example of Pages===
===Example of Pages===
For examples of high quality pages, please check:
For examples of high quality pages, please check:
* [[Tumor lysis syndrome resident survival guide]]
* [[STEMI resident survival guide]]
* [[Bradycardia resident survival guide]]
* [[Bradycardia resident survival guide]]
* [[Alcohol withdrawal resident survival guide]]
* [[Cardiac tamponade resident survival guide]]

Revision as of 14:26, 17 April 2015

Resident Survival Guide
Introduction
Team
Guide
Page Template
Examine the Patient Template
Navigation Bar Template
Checklist
Topics

Editor-In-Chief: C. Michael Gibson, M.S., M.D. [1]; Associate Editor(s)-in-Chief: Rim Halaby, M.D. [2]; Vendhan Ramanujam M.B.B.S [3]

Overview

The following items in this checklist describe in detail the resident survival guide pages. All these items should be present for a page to be complete and ready for quality check.

Checklist

General Structure

  • In general, each page contains the following titles in order:
    • Overview
    • Classification (if needed for the management)
    • Causes
    • FIRE
    • Complete Diagnostic Approach
    • Treatment
    • Do's
    • Dont's
    • References
  • The treatment for some diseases is extensive or it can be subdivided into sections. In this case, appropriate headings are used to organize the treatment. Click here for an example.

Floating Navigation Bar

  • A navigation bar is present on every resident survival guide page. Click here for a template.
  • For an example of a page with a floating navigation bar, check STEMI resident survival guide.
  • The navigation bar should contain the following items: overview, classification (if applicable), causes, FIRE, complete diagnostic approach, treatment, do's and don'ts. However, the content of the navigation bar is flexible.
    • If you have added an additional title or subtitle on your page make sure to add it in the navigation bar.
    • If the therapy is divided into several sections, modify the content of the navigation bar to fit the order of the titles of the resident survival page. Click here for an example.

Overview

  • The overview section is a short and straight to the point statement that summarizes the disease and its management in few sentences, particularly the immediate management.
  • The overview section should include the disease name in the first sentence.
  • To see an example of an overview section on the resident survival guide, click here.

Classification

  • The classification section should be included only when the classification of the disease is needed for the management plan.
  • This section provides either a table or a list of subheadings of categories with content that the disease can be classified under.
  • To see an example of a classification section on the resident survival guide, click here.

Causes

  • The causes section contains two subheadings:
    • Life Threatening Causes
    • Common Causes
  • Under life threatening causes, the following definition of life threatening is provided: Life-threatening causes include conditions which may result in death or permanent disability within 24 hours if left untreated.
    • If the disease itself is life threatening, the following sentence is written: [[Name of the disease]] is life threatening and should be treated as such irrespective of the underlying cause.
  • Under common causes, only the common causes are provided, without including rare etiologies.
  • The causes are listed in alphabetical order.
  • The causes are all hyperlinked.

FIRE

Complete Diagnostic Approach

  • The complete diagnostic approach section contains the diagnostic algorithm(s).
  • If the diagnostic approach is very big and the algorithm is complicated, the algorithm is divided into more than one.
  • If more than one algorithm is provided, a subtitle is given for each.
  • When more than one algorithm are provided, separate them with <br>.
  • The algorithm for diagnosis contains at least the following
    • Characterize the symptoms
    • Obtain a detailed history
    • Examine the patient
    • Order labs
    • Order imaging studies
    • Consider alternative diagnoses

Treatment

  • The treatment section contains the therapeutic algorithm(s).
  • The number of algorithms depends on each topic.
  • If the therapeutic approach is very big and the algorithm is complicated, the algorithm is divided into more than one.
  • If more than one algorithm is provided, a subtitle is given for each.
  • When more than one algorithm are provided, they are separated with <br>.
  • Details about the dosage, route, and frequency of the medications are provided.
  • Major contraindications for the medications are provided in red. Click here for an example.
  • Action verbs are used before medications or treatment, for example: "Administer aspirin" instead of aspirin.
  • Check-boxes “❑” are placed in front of every action.
  • Urgent or Immediately are added when an action should be taken as soon as possible.
  • When the algorithm contains a big management plan already developed on another resident survival page, the management should not be replicated but rather redirected to the other resident survival guide page.

Description of The Algorithm

  • Before starting the algorithm, the following sentence is written and the main reference(s) of the algorithm are cited:

Shown below is an algorithm depicting [...] based on [...].(references)

  • Abbreviations should be avoided, example: hour and not hr, minute and not min.
    • If abbreviations are used, provide a list of abbreviated terms above the algorithm as follows:

<span style="font-size:85%">'''Abbreviations:''' '''BUN''': Blood urea nitrogen; '''CAD''': Coronary artery disease; '''CBC''': Complete blood count; '''EKG''': Electrocardiogram; '''Hb''': Hemoglobin; '''ICU''': Intensive care unit; '''INR''': International normalized ratio; '''IV''': Intravenous; '''GI''': Gastrointestinal; '''NPO''': Nil per os; '''NSAIDs''': Non steroid anti-inflammatory drugs</span>

And it will appear this way:
Abbreviations: BUN: Blood urea nitrogen; CAD: Coronary artery disease; CBC: Complete blood count; EKG: Electrocardiogram; Hb: Hemoglobin; ICU: Intensive care unit; INR: International normalized ratio; IV: Intravenous; GI: Gastrointestinal; NPO: Nil per os; NSAIDs: Non steroid anti-inflammatory drugs

Click here for an example.


  • The algorithm should be drawn on a paper then replicated on WikiDoc in a way that the algorithm is minimally spaced.
  • The algorithm and content are aligned to the left, and the size of each box is adjusted using the following formula:
    • <div style="float: left; text-align: left; width: 25em; padding:1em;"> [content of the box] </div>
  • The algorithm should contain the following:
    • Characterize the symptoms:
    • Obtain a detailed history:
    • Examine the patient:
    • Order labs:
    • Order imaging studies:
    • Consider alternative diagnoses:
  • Action verbs are used before medications or treatment, for example: "Administer aspirin" instead of aspirin
  • Check-boxes ❑ are placed in front of every action.
  • Urgent or Immediately are added when an action should be taken as soon as possible.
  • When a medication is to be administered, the dose and mode of administration are included.
  • When the algorithm contains a big management plan already developed on another resident survival page, the management should not be replicated but rather redirected to the other reisdent survival guide page.

Do's

  • Extra information and details about the management are provided in this section.
  • Each sentence is written as an order, for example:
    • Order an EKG. (correct)
    • An EKG should be ordered. (incorrect)
  • Write the important do’s within the algorithms.

Dont's

  • Extra information and details about what should be avoided in the management are provided in this section.
  • Each sentence is written as an order, for example:
    • Do not administer beta blockers. (correct)
    • Beta blockers should not be administered. (incorrect)

References

  • Make sure to use the latest guidelines and recommendations as references.
  • Make sure that the links of the references are working.

General Notes

  • When more that one associate editors are included, separate the names by a a semicolon followed by a space.
  • Expand buttons should be avoided as much as possible.
  • Hyperlinks through [[ ]] are used to link key words to their pages.
  • The page should be reviewed for typographical errors and capitalization.
  • Add categories for each section. Make sure that [[category:Resident survival guide]] is present among others, for example: [[Category:Cardiology]].
  • Make sure that a siren is present on all the pages of each of the resident survival guide's topics.
  • Contributors who are not native English speakers and require help in writing should add the Category:Grammar to their pages.

Example of Pages

For examples of high quality pages, please check: