Difference between revisions of "WikiAnesthesia Style Guide"

Latest revision as of 09:03, 31 March 2021

This page offers some guidance about writing for WikiAnesthesia in a way that maintains quality and consistency throughout the site, ensures content is displayed optimally, and that it can be as useful as possible to those using the site.

Wikianesthesia is made by its users and this page only serves as guidance, even this page can be edited by anyone.

General Advice

Target audience

Tone/Language

Approaching controversy/differences of opinion

Acronyms, brand names, etc.

Site Structure

This might be better within the ToC page

Citations

Recommended sources
Citing oneself?

Citations for the whole article rather than for a specific point being mad

Formatting

Tables

Templates

Styles

Bullets

Info Boxes

Spacing

etc.

Images and Other Media

Conflicts of Interest

Etiquette

Editing other users' work

Pages in progress?

@@ Line 4: / Line 4: @@
 == General Advice ==
+''Target audience''
-* WikiAnesthesia is intended to provide concise, clinically relevant information that is useful at the point of care, rather than a resource for studying/exam preparation or in-depth critical literature review.
+''Tone/Language''
-** If you would like to create other types of content please do so - but keep it separate from clinical reference pages.
-*There are disagreements and controversies within anesthesia, when this is the case try not to write prescriptive recommendations but instead acknowledge that differences of opinion exist and consider very briefly discussing the issue.
+''Approaching controversy/differences of opinion''
-*WikiAnesthesia is meant for users around the world, with this in mind try to do the following:
-**Use generic names for drugs and devices
+Acronyms, brand names, etc.
-**...
-**...
+== Site Structure ==
+''This might be better within the ToC page''
 ==Citations==
+<blockquote>''Recommended sources''
+''Citing oneself?''
-*Those reading WikiAnesthesia can benefit from the know-how of experienced anesthesiologists, so if you are an expert in your field or have been taught by one please add your personal recommendations and cite yourself!
+''Citations for the whole article rather than for a specific point being mad''</blockquote>
-**''This approach'' may produce ''these effects (1) - 1: Expert, Professor; personal communication / User ID, Professor of Anesthesia; personal recommendation''
-**Endorsing personal recommendations
-**If there is published work then please replace
-*'''Citing single or small number of resources that are the basis for the entire article, rather than as references for individual sentences/paragraphs/sections'''
-== Conflicts of Interest ==
+== Formatting ==
+''Tables''
-== Editing Other User's Work ==
+''Templates''
-== Formatting and Structuring Articles ==
+''Styles''
-Tables
-Templates
+''Bullets''
-Styles
+''Info Boxes''
-Bullets
+''Spacing''
-Info Boxes
+''etc.''
 ==Images and Other Media==
+== Conflicts of Interest ==
+== Etiquette ==
+''Editing other users' work''
+''Pages in progress?''