Updating and creating notes on WikEM: Difference between revisions

No edit summary
(78 intermediate revisions by 10 users not shown)
Line 1: Line 1:
{{Getting started}}
{{Getting started}}


== Creating a New Note ==
==General Guidelines==
#'''YOU MUST FIRST LOGIN'''  
*Keep entries concise yet informative
**Preference is for notes, not chapters (i.e. think Pepid, not UpToDate)
*Remember that the most common user format is the smart phone (view it on your phone to see the final format)
*Focus on practical knowledge. Describe pathophysiology only when necessary for bedside treatment.
*[[Updating_and_creating_notes_on_WikEM#Internal_Links|Link]] to other WikEM pages whenever possible
*[[Updating_and_creating_notes_on_WikEM#References|Reference]] your sources
**This is particularly important when adding information to established pages or making any kind of claim that is not universally agreed upon by medical practitioners
*Feel free to divide notes into several notes, or combine them if it makes them more useful
 
==Creating a New Note==
===Step by Step===
#'''YOU MUST FIRST LOGIN'''
#*See [[Create an Account]]  
#*See [[Create an Account]]  
#**'''You must confirm your email address (check your email account) before the site will give you the ability to make changes.'''
#**'''You must confirm your email address (check your email account) before the site will give you the ability to make changes.'''
#'''Search for the term''' in the search field in the upper right hand corner of the page  
#'''Search for the term''' in the search field in the upper right hand corner of the page  
#*If you find a note with a similar theme, please edit it instead with your new content (see below) rather than making a duplicate page
#*If you find a note with a similar theme, please edit it instead with your new content (see below) rather than making a duplicate page
#*If you don't find a note on your subject, click on the link: '''"Create the page on this wiki!"'''  
#*If you do not find a note on your subject, click on the link: '''"Create the page on this wiki!"'''  
#**Use the Boilerplate (Template) function for your type of note (see Templates below)
#**Use the Boilerplate (Template) function for your type of note (see Templates below)
#Please follow [http://en.wikipedia.org/wiki/Wikipedia:Tutorial/Formatting formatting guidelines] below
#Please follow formatting guidelines
#Put a category at the end of the entry
 
===Using a Boilerplate Page Template===
*You can auto-generate Boilerplate Templates when creating a new note (click on function at top of new note page)
*Contributors are encouraged to update old pages to the current templates, when applicable
*Current templates are:
**[[Template:Standard|Standard Template]]
**[[Template:JCReview|Journal Club Review]]
**[[Template:LitReview|Evidence-Based Lit Review]]
**[[Template:Ultrasound|Ultrasound Scan]]
**[[Template:Medication|Medication Template]]
**[[Template:Procedure|Procedure Template]]
**[[Template:ResidencyPage|Residency Page Template]]


== Guidelines==
*Boilerplate source (for adding new templates) is at [[MediaWiki:Multiboilerplate]]
*Keep entries concise yet informative
**Preference is for notes, not chapters (i.e. think Pepid, not UpToDate)  
*Remember that the most common user format is the smart phone (view it on your phone to see the final format)
*Focus on practical knowledge. Describe pathophysiology only when necessary for bedside treatment.
*[[Updating_and_Creating_Notes_on_WikEM#Footnote_Referencing|Reference]] other notes whenever possible
*Put your source(s) in a "Sources" section or use the Footnote Referencing function
*Put a category at the end of the entry
*Feel free to divide notes into several notes, or combine them if it makes them more useful
*Use one of the [[Updating_and_Creating_Notes_on_WikEM#Boilerplate_Templates|Templates]] to autogenerate sections in new articles


==Editing Notes==
==Editing Notes==
<big>*Please read the '''[http://en.wikipedia.org/wiki/Wikipedia:Tutorial/Formatting wikipedia tutorial:]'''</big>
#First search (upper right hand corner; login first) for the note that you want to edit
#Once on the relevant page, click on the Edit button in the top right-hand corner to edit the page
#*'''If you do not see the edit button, you are probably not logged in!''' (login to see it)
 
==Basic Formatting==
<big>*Please read the '''[http://en.wikipedia.org/wiki/Wikipedia:Tutorial/Formatting wikipedia tutorial]'''</big>
===Text Format===
*<nowiki>You type: '''Bold'''</nowiki>
**You see: '''Bold'''
*<nowiki>You type: ''Italics''</nowiki>
**You see: ''Italics''
 
===Headings===
===Headings===
*<nowiki>==Heading 1==</nowiki>
*<nowiki>==Heading 1==</nowiki>
Line 29: Line 55:
*<nowiki>====Heading 3====</nowiki>
*<nowiki>====Heading 3====</nowiki>


===Bullet points (Prefered)===
===Bullet points (Preferred)===
*<nowiki>*Level 1</nowiki>
*<nowiki>*Level 1</nowiki>
**<nowiki>**Level 2</nowiki>
**<nowiki>**Level 2</nowiki>
Line 35: Line 61:
****<nowiki>****Level 4</nowiki>
****<nowiki>****Level 4</nowiki>


===Outline numbers (Less preffered than bullet points; see above)===
===Outline numbers (Less preferred than bullet points; see above)===
#<nowiki>#Level 1</nowiki>  
#<nowiki>#Level 1</nowiki>  
##<nowiki>##Level 2</nowiki>
##<nowiki>##Level 2</nowiki>
Line 41: Line 67:
####<nowiki>####Level 4</nowiki>
####<nowiki>####Level 4</nowiki>


===Category ===
===Category===
*<nowiki>[[Category:NameOfCategory']] </nowiki>
*<nowiki>[[Category:NameOfCategory']] </nowiki>
*See list of [[categories]]
*See list of [[Portal:Categories|categories]]
 
==Links to Other Pages==


===Internal Links===
===Internal Links===
*<nowiki>[[NameOfLinkedToNote]] </nowiki>
*Standard: <nowiki>[[NameOfLinkedToNote]] </nowiki>
*Internal link with different label: <nowiki>[[NameOfLinkedToNote|LinkedNote]] </nowiki>


===External Links===
===External Links===
Line 52: Line 81:
*External link with different label: <nowiki>[http://mediawiki.org MediaWiki]</nowiki>
*External link with different label: <nowiki>[http://mediawiki.org MediaWiki]</nowiki>


===Images===
==References==
*Upload image in .jpg or .png format using the "Upload file" on the left. All images should be "creative commons" licensed
*<nowiki>[[File:File.jpg]]</nowiki>to use the full version of the file
*<nowiki>[[File:File.png|200px|thumb|left|alt text]]</nowiki> to use a 200 pixel wide rendition in a box in the left margin with 'alt text' as description
*<nowiki>[['''Media:File.ogg''']]</nowiki>for directly linking to the file without displaying the file
 
===Footnote Referencing===
===Footnote Referencing===
*Add the tags <code>&lt;ref></code>and <code></ref></code>on either side of the journal citation
*Add the tags <code>&lt;ref></code>and <code></ref></code>on either side of the journal citation
*Place the tag <code>&lt;references/></code> at the bottom of the article in the Sources Section for auto-generated footnotes
*Place the tag <code>&lt;references/></code> at the bottom of the article in the Sources Section for auto-generated footnotes
*References follow a 1 author [http://www.lib.jmu.edu/citation/amaguide.pdf AMA style]: Spencer J. et al. Physician, heal thyself – but not on your own please. Med Educ. 2005; 89: 548-549.
*References should utilize primary literature whenever possible.
*Secondary and Tertiary (textbook) sources are permitted however they must be clearly referenced and follow the [http://www.lib.jmu.edu/citation/amaguide.pdf AMA style guide].


====Multiple Footnotes of Same Source====
===Multiple Footnotes of Same Source===
To give a footnote a unique identifier, use '''&lt;ref name="name">'''. You can then refer to the same footnote again by using a ref tag with the same name. The text inside the second tag doesn't matter, because the text already exists in the first reference. You can either copy the whole footnote, or you can use a terminated empty ref tag that looks like this: '''&lt;ref name="name" />'''. The quotes are not required (but still correct) if the name contains no embedded spaces. The space before the closing "/" may be omitted.
To give a footnote a unique identifier, use '''&lt;ref name="name">'''. You can then refer to the same footnote again by using a ref tag with the same name. The text inside the second tag does not matter, because the text already exists in the first reference. You can either copy the whole footnote, or you can use a terminated empty ref tag that looks like this: '''&lt;ref name="name" />'''. The quotes are not required (but still correct) if the name contains no embedded spaces. The space before the closing "/" may be omitted.


===Quizes===
===Citation Needed===
*Insert the following tag: <nowiki>{{Citation needed|reason=Reliable source needed|date=MONTH YEAR}}</nowiki>
**MONTH/YEAR = date of citation request inserted
 
==Images==
===Finding Images===
*You can use most images from Wikipedia
*Search the web with [http://openi.nlm.nih.gov/ OPENi-An Open Access Biomedical Image Search Engine]
 
===To upload an image to WikEM===
*Log-in
*Click on the link [[Special:Upload]] which appears under 'Toolbox' in the links on the left
**Please cite the source of the image in the "Summary" section. (source webpage or article if from OPENi-An, website e.g. Wikimedia Commons, etc)
**If not from commonly used source (OPENi-An, Wikipedia, Wikimedia Commons), please also note the image license, if known (should be Creative Commons or similar)
 
===To insert an image into a page===
*Within the relevant file insert the following:
**Our standard '''<nowiki>[[File:Image-file-name.jpg|thumb|Writing that you want on the bottom of the photo]]</nowiki>'''
 
===Other===
*To see a list of uploaded images by WikEM users see [[Special:ListFiles]]
*To direct link to the file without displaying the file use: '''<nowiki>[['''Media:File.ogg''']]</nowiki>'''
 
==Tables==
*Make a table in excel and copy all the cells
*Paste it into: http://wang.wustl.edu/mediawiki/extensions/index.php
*Then paste the text into the wiki page you are editing
 
==Redirects==
To make a redirect from some search term (e.g. Zofran) to a note (e.g. Ondansteron)
*Create a new page for "Zofran" (see above on how to create a new page)
**In the new page type the redirect code (and only the redirect code): '''<nowiki>#REDIRECT[[DestinationPageName]]</nowiki>'''
***Example:  '''<nowiki>#REDIRECT[[Ondansteron]]</nowiki>'''
 
==Templates in Text (Transposition)==
*Used to have the same text on multiple pages
**Used frequently in the Differential Diagnosis sections and then placed on the respective pages
*To make a template, place {{ symbol around it in the text
**Example: '''<nowiki>{{Template page name}}</nowiki>'''
*To search for template, use "Template:" before the template page name in the search bar (e.g. "Template:Template page name")
*'''There is a known issue with the template not immediately appearing on edited pages due to catching. Please give it a couple of minutes and it will eventually appear or just make another edit on the page.'''
 
==Quizzes==
{| class="prettytable"
{| class="prettytable"
!wikitext!!rendering!!comments
!wikitext!!rendering!!comments
Line 99: Line 168:
|}
|}
|valign="top"|
|valign="top"|
* Feedback is text which is initially hidden, and then shown to the user when they submit the quiz for correction. Feedback typically serves the purposes of encouragement, explanation, congratulation and commiseration.
*Feedback is text which is initially hidden, and then shown to the user when they submit the quiz for correction. Feedback typically serves the purposes of encouragement, explanation, congratulation and commiseration.
* Feedback is set with all types by using a double vertical line '''||''' immediately after a response.  
*Feedback is set with all types by using a double vertical line '''||''' immediately after a response.  
* The pipes beginning the ''feedback'' section must be on a new line.
*The pipes beginning the ''feedback'' section must be on a new line.
* Unlike some other quiz systems, '''all''' feedback items are displayed on correction. With other quiz systems, the norm is to display the feedback only for those items which were selected by the user.
*Unlike some other quiz systems, '''all''' feedback items are displayed on correction. With other quiz systems, the norm is to display the feedback only for those items which were selected by the user.
* To try out the feedback effect, choose a response and click the correction button. The feedback will then appear.
*To try out the feedback effect, choose a response and click the correction button. The feedback will then appear.
|}
|}


==Boilerplate Templates==
==See Also==
*You can auto-generate Boilerplate Templates when creating a new note (click on function at top of new note page)
*Contributors are encouraged to update old pages to the current templates, when applicable
*Current templates are:
**[[Template:Standard|Standard Template]]
**[[Template:JCReview|Journal Club Review]]
**[[Template:Quiz|Quiz Set]]
**[[Template:GEMC|GEMC]]
***Directions at *[[Template Directions (GEMC)]]
**[[Template:Medication|Medication Template]]
**[[Template:Procedure|Procedure Template]]
 
*Boilerplate source (for adding new templates) is at [[MediaWiki:Multiboilerplate]]
 
== Images  ==
*To upload an image to WikEM
**Log-in
**Click on the link [[Special:Upload]] which appears under 'Toolbox' in the links on the left
***The page also includes directions for how to use the images once uploaded
***Please be considerate of the Style Guidelines
***For formatting of the file (resizing, thumbnails, etc..) please refer to http://www.mediawiki.org/wiki/Help:Images#Linking_to_an_image_without_displaying_it
*To see a list of uploaded images by WikEM users see [[Special:ListFiles]]
 
== Standardized Abbreviations  ==
*CXR Chest X-Ray / Radiograph
*DM Diabetes Mellitus
*HTN Hypertension
*DDx Differential Diagnosis
 
==Tables==
*Use http://excel2wiki.net/
**Then, change first line to:  {| class="wikitable"
*Can see WikiMedia [[Template:Table|special Notation]]
 
== See Also ==
*[[Getting started]]
*[[Helping out on WikEM]]
*[[Helping out on WikEM]]
*[[Resident Editors]]
*[[WikEM editorial levels]]
*[[Needed Pages]]
*[[Needed Pages]]


[[Category:WikEM]]
[[Category:WikEM]]

Revision as of 19:45, 5 April 2020

Getting Started

Thanks for wanting to help out on WikEM! People are the core of the wiki. Your knowledge translates into improved bedside practice for everyone.

To get started

If you are looking for ways to contribute

Also

General Guidelines

  • Keep entries concise yet informative
    • Preference is for notes, not chapters (i.e. think Pepid, not UpToDate)
  • Remember that the most common user format is the smart phone (view it on your phone to see the final format)
  • Focus on practical knowledge. Describe pathophysiology only when necessary for bedside treatment.
  • Link to other WikEM pages whenever possible
  • Reference your sources
    • This is particularly important when adding information to established pages or making any kind of claim that is not universally agreed upon by medical practitioners
  • Feel free to divide notes into several notes, or combine them if it makes them more useful

Creating a New Note

Step by Step

  1. YOU MUST FIRST LOGIN
    • See Create an Account
      • You must confirm your email address (check your email account) before the site will give you the ability to make changes.
  2. Search for the term in the search field in the upper right hand corner of the page
    • If you find a note with a similar theme, please edit it instead with your new content (see below) rather than making a duplicate page
    • If you do not find a note on your subject, click on the link: "Create the page on this wiki!"
      • Use the Boilerplate (Template) function for your type of note (see Templates below)
  3. Please follow formatting guidelines
  4. Put a category at the end of the entry

Using a Boilerplate Page Template

Editing Notes

  1. First search (upper right hand corner; login first) for the note that you want to edit
  2. Once on the relevant page, click on the Edit button in the top right-hand corner to edit the page
    • If you do not see the edit button, you are probably not logged in! (login to see it)

Basic Formatting

*Please read the wikipedia tutorial

Text Format

  • You type: '''Bold'''
    • You see: Bold
  • You type: ''Italics''
    • You see: Italics

Headings

  • ==Heading 1==
  • ===Heading 2===
  • ====Heading 3====

Bullet points (Preferred)

  • *Level 1
    • **Level 2
      • ***Level 3
        • ****Level 4

Outline numbers (Less preferred than bullet points; see above)

  1. #Level 1
    1. ##Level 2
      1. ###Level 3
        1. ####Level 4

Category

  • [[Category:NameOfCategory']]
  • See list of categories

Links to Other Pages

Internal Links

  • Standard: [[NameOfLinkedToNote]]
  • Internal link with different label: [[NameOfLinkedToNote|LinkedNote]]

External Links

  • Standard: http://mediawiki.org
  • External link with different label: [http://mediawiki.org MediaWiki]

References

Footnote Referencing

  • Add the tags <ref>and </ref>on either side of the journal citation
  • Place the tag <references/> at the bottom of the article in the Sources Section for auto-generated footnotes
  • References follow a 1 author AMA style: Spencer J. et al. Physician, heal thyself – but not on your own please. Med Educ. 2005; 89: 548-549.
  • References should utilize primary literature whenever possible.
  • Secondary and Tertiary (textbook) sources are permitted however they must be clearly referenced and follow the AMA style guide.

Multiple Footnotes of Same Source

To give a footnote a unique identifier, use <ref name="name">. You can then refer to the same footnote again by using a ref tag with the same name. The text inside the second tag does not matter, because the text already exists in the first reference. You can either copy the whole footnote, or you can use a terminated empty ref tag that looks like this: <ref name="name" />. The quotes are not required (but still correct) if the name contains no embedded spaces. The space before the closing "/" may be omitted.

Citation Needed

  • Insert the following tag: {{Citation needed|reason=Reliable source needed|date=MONTH YEAR}}
    • MONTH/YEAR = date of citation request inserted

Images

Finding Images

To upload an image to WikEM

  • Log-in
  • Click on the link Special:Upload which appears under 'Toolbox' in the links on the left
    • Please cite the source of the image in the "Summary" section. (source webpage or article if from OPENi-An, website e.g. Wikimedia Commons, etc)
    • If not from commonly used source (OPENi-An, Wikipedia, Wikimedia Commons), please also note the image license, if known (should be Creative Commons or similar)

To insert an image into a page

  • Within the relevant file insert the following:
    • Our standard [[File:Image-file-name.jpg|thumb|Writing that you want on the bottom of the photo]]

Other

  • To see a list of uploaded images by WikEM users see Special:ListFiles
  • To direct link to the file without displaying the file use: [['''Media:File.ogg''']]

Tables

Redirects

To make a redirect from some search term (e.g. Zofran) to a note (e.g. Ondansteron)

  • Create a new page for "Zofran" (see above on how to create a new page)
    • In the new page type the redirect code (and only the redirect code): #REDIRECT[[DestinationPageName]]
      • Example: #REDIRECT[[Ondansteron]]

Templates in Text (Transposition)

  • Used to have the same text on multiple pages
    • Used frequently in the Differential Diagnosis sections and then placed on the respective pages
  • To make a template, place {{ symbol around it in the text
    • Example: {{Template page name}}
  • To search for template, use "Template:" before the template page name in the search bar (e.g. "Template:Template page name")
  • There is a known issue with the template not immediately appearing on edited pages due to catching. Please give it a couple of minutes and it will eventually appear or just make another edit on the page.

Quizzes

wikitext rendering comments
 {Question
 |type="()"}
 + The correct answer.
 || Feedback for correct answer.
 - Distractor.
 || Feedback for distractor.
 - Distractor.
 || Feedback for distractor.
 - Distractor.
 || Feedback for distractor.

Question

The correct answer.
Distractor.
Distractor.
Distractor.

  • Feedback is text which is initially hidden, and then shown to the user when they submit the quiz for correction. Feedback typically serves the purposes of encouragement, explanation, congratulation and commiseration.
  • Feedback is set with all types by using a double vertical line || immediately after a response.
  • The pipes beginning the feedback section must be on a new line.
  • Unlike some other quiz systems, all feedback items are displayed on correction. With other quiz systems, the norm is to display the feedback only for those items which were selected by the user.
  • To try out the feedback effect, choose a response and click the correction button. The feedback will then appear.

See Also