Resident survival guide checklist: Difference between revisions

Jump to navigation Jump to search
Rim Halaby (talk | contribs)
Vendhan Ramanujam (talk | contribs)
No edit summary
Line 38: Line 38:


===Classification===
===Classification===
* The classification section should be included 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 the categories that the disease can be classified under.
* This section provides 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 58: Line 58:
* 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>.
* 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===
===Treatment===
* The treatment section contains the therapeutic algorithm(s).
* The treatment section contains the therapeutic algorithm(s).
* The number of algorithms depends on each topic.
* 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 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.
* 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.
* 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===
===Description of The Algorithm===
Line 105: Line 116:
** Order an EKG. (correct)
** Order an EKG. (correct)
** An EKG should be ordered. (incorrect)
** An EKG should be ordered. (incorrect)
* Write the important do’s within the algorithms.


===Dont's===
===Dont's===
Line 113: Line 125:


===References===
===References===
* Make sure to use in the references the latest guidelines and recommendations.
* Make sure to use the latest guidelines and recommendations as references.
* Make sure that the links of the references are working.


===General Notes===
===General Notes===
* When more that one associate editors are includes, separate them by a a semicolon followed by a space.
* When more that one associate editors are includes, separate the names by a a semicolon followed by a space.
* Provide synonyms and keywords on the top of each page.
* 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.
Line 124: Line 137:
* 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 the main page 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 speaking 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.
===Check Content With Other Resources===
* Uptodate
* Medscpae
* Epocrates
* Sabatine book
* NICE pathways
* Merck manual 


===Example of Pages===
===Example of Pages===

Revision as of 20:40, 20 March 2014

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 details the resident survival guide pages. All those 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
    • Diagnosis
    • Treatment
    • Prophylaxis (if applicable)
    • Do's
    • Dont's
    • 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 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 appendicitis 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.
    • 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 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 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 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.

Diagnosis

  • The diagnosis section contains the diagnostic algorithm(s).
  • The number of algorithms depends on each topic.
    • 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 includes, 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.
  • 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 the main page 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.
  • In Category: Grammar is added on the pages of contributors who are not native English speaking and require help in writing.

Check Content With Other Resources

  • Uptodate
  • Medscpae
  • Epocrates
  • Sabatine book
  • NICE pathways
  • Merck manual

Example of Pages

For examples of high quality pages, please check: