Help:How to Suggest Changes

The Medpedia knowledge base is the collaborative encyclopedia and resource for information about health, medicine and the body. Anyone can contribute, and there are multiple ways of contributing. If you are a physician or Ph.D. in the biomedical field and have been approved by the community, you can make changes directly to Medpedia wiki. If you are anyone else, you can use the "Suggest Changes" link at the top of any page to make a suggestion for that page. An approved Editor will review and potentially add your suggestion to the knowledge base.

This page serves as a reference guide for suggesting changes on the wiki.

The first section gives step-by-step instructions on using the site and editing. Following that section are guides to each specific type of page, with an explanation, examples, and specifications for what it should include. There is also a Style Guide covering various issues of language, formatting, and other stylistic specifics. Finally there is a space with helpful hints, with shortcuts and tricks for editing.


Contents

How To:

Suggest Changes

  • Find a page for which you want to suggest changes
    • By searching for a topic name (be sure to search alternate spellings and names, too.)
    • Or by browsing All Pages
  • Click the “Suggest Changes” tab
  • Make the appropriate changes in the white editing box.
  • Click “Preview” to see the changes you made before saving.
  • Click “Submit Suggested Changes” to submit your changes for review by an Editor. An approved Editor will review and potentially add your suggestion.

Use the Toolbar

The toolbar at the top of the edit box automatically inserts wiki formatting text. Place your cursor in the space you want the formatting text inserted, or highlight the text you want to format, and click on the appropriate button.

Use Templates

  • In the Edit screen, click “Choose a Template.”
  • Select the appropriate template.
  • To enter a headline, place your cursor in the edit box where you want the headline to go, and then click on the headline in the Template box.

Add an Image

  • Save the image you want to a location on your computer
  • Place your cursor where you want the image to go.
  • Click on the image icon in the toolbar. This will insert the proper image text.
  • Replace the text “Example.jpg” with the appropriate title of your image file.
  • After the “.jpg” you want a vertical line (“|” above the “\”) and the word “thumb” followed by another vertical line, the size, and another vertical line. Normal size is 300px, with 200px for smaller images and 400px for larger. Play around and see how the sizes look.
  • After you have specified the size, you can specify location. The right side of the page is the default, but if you want the image on the left or centered, you need to specify.
  • After the location, place another vertical line, and then the caption. The caption should always include the source, in italics.
  • Put everything together, and you get wiki text that looks something like: [[Image:apple_orgchard.gif|thumb|300px|center|This photo shows an apple orchard in New Jersey. ‘’Source: Own Image]]
  • Save the page.
  • If an image with the same file name has already been uploaded to Medpedia, the image will appear automatically.
  • If there is no image with the filename on the site, you will have to upload it.
    • Click on the blue image name, which will redirect to an “Upload File” page.
    • Click “Choose File,” and then find and click on the file in your computer.
    • Make sure the “Destination filename” matches what you have in the main Article (it should default in correctly).
    • Type in a brief description and the image source under “Summary”
    • Upload File

Add a Video

  • To embed a YouTube video on a page, locate the code from the "Embed" box—you can find it in the "About This Video" box as you're watching the video
  • Locate the piece of the code that looks like this: http://www.youtube.com/v/6YQLG4Aqkwo&hl=en
  • Then, use the following syntax: {{#ev:youtube|a1Y73sPHKxw}}

Add a Reference

  • In the text, directly after the sentence for which you want to create a citation, type <ref> , then insert the properly-formatted reference text , ending with </ref>
  • Under the “References” heading at the bottom of the page, type <references /> and all of the references you inserted throughout the text above will automatically appear.
  • At the top of the editing box, you will also find an icon that enters the reference wiki text when you click it)

Add a Category

  • Click on the "+Category" button in the Toolbar.
  • Start typing in the appropriate category name (e.g. "Cardiovascular" for the Heart Attack page).
  • Choose the appropriate category name, and save.
  • Repeat for as many categories as you deem appropriate.

Add an Internal Link

Double brackets or the "Internal Link" icon (Ab underlined) can help you link words in one Article to another.

  • For single words, simply enclose the word in brackets. (e.g. [[diabetes]] will give you this result: diabetes
  • For terms comprised of more than one work, first write the term with capitalization as it appears in the title, then insert a vertical line, and type the text as you want it to appear. (e.g. [[Heart Attack|heart attack]] will give you heart attack
  • You can follow a similar procedure when the name of the title is slightly different than what you want to type. (e.g. [[High Blood Cholesterol|high cholesterol]] will give you high cholesterol

Add an External Link

Single Brackets of the "External Link" (globe) icon can help you make a word or phrase link to an external site.

  • Type the website, including the "http://" followed by a space and then the name of the site (e.g. Use [http://www.hearthealthinternational.org ICHA] to get ICHA.)

Create a Debate Page

  • Copy and paste the debate template onto the page, then click "Preview" to see what you have.
  • Once you see the preview, scroll down to edit the text, replacing the generic text (e.g. “Camp 1” and “Camp 2”) with the specific appropriate text (e.g. “Cover your mouth with your hand when you sneeze” and “Sneeze into your sleeve.”)

Use a “Discuss” Page

  • Once you’re on an article page, click on the “Discuss” tab.
  • To add a new topic of discussion, click the “+” button.
  • Type in a heading for your topic of discussion, with the full text underneath.
  • Click on the Signature icon button to sign your posting with your username and the date/time of your post.

See Previous Edits to an Article

  • From an article page, click on the “History” tab.
  • Select the two versions of the article that you would like to compare.
  • Click “Compare Selected Versions.”
  • Additions will appear in blue with a “+” next to the lines that were added, and deletions will appear a pinkish-red and crossed out.
  • You can undo the last edit to a page by clicking “rollback” next to the edit.

Page Specifications and Explanations

Below you will find specifics on what each page should include. See the Style Sheet for specific stylistic guidelines and suggestions.

The "Plain English" Page

The "Plain English" page is the page on which the general public will land when they come to the site or search for a topic. Examples can be found under the specific page topics, but in general it:

  • Is written towards a 9th grade, lay audience.
  • Refers to patients in the third person
  • Provides information, not advice
  • Uses layperson’s terms when describing symptoms, medications, conditions, etc (See Jargon Watch for terms to avoid and their lay equivalents)
  • Includes at least one image (preferably at the top, above the “fold” of the page)
  • Title: All words are capitalized and uses layperson’s terms
  • Includes an “Introduction” section at the very top, with 1-2 sentences giving readers enough background to get them started
  • Always includes references (See the Style Guide for details on how to create references)
  • Follows the appropriate template (See specific page topics below for more details)
  • Can be claimed by an editor by clicking on the blue “Be a Lead Editor of this article” link
    • By claiming an article, Lead Editors take responsibility and credit for the content on the page and implicitly agree to monitor all edits made to the page by other editors

The “Clinical” Page

The "Clinical" Page is geared towards medical professionals, with more in-depth, technical information and terminology. Examples include Clinical:Schizophrenia.
It should:

  • Be written in the third person
  • Provide information, not advice
  • Use scientific terms when appropriate

“Discuss” Tab

The “Discuss” tab is a talk page where everyone can discuss the Article, changes they want to make, and any editing-related questions specific to the article. Since this is not a content page, there are no specifications for what should and should not be on it, provided the tone remains respectful and the discussion constructive.

The Debate Page

The Debate Page is a space to educate the public about the debate surrounding a particular issue. It is a space to lay out the various "Camps of Thought," or points of view/sides of the argument. It is not a place for the different sides to engage in discussion or debate and should never include disparaging comments or attacks on other points of view.
In general, the “Debate” page:

  • Includes a paragraph on each different “camp of thought,” or point of view/side of the debate
    • Each paragraph can be written a member of that side, or someone who represents those views. It should outline their position in 4-8 sentences, describing but not arguing.
  • Does not include discussion amongst the different sides
  • Is written with language that is respectful and appropriate to an educational piece

Diseases and Conditions

Diseases and Conditions cover any ailment caused by virus, bacteria, genetics, environment, injury, etc, describing the condition, its causes, treatments, research, history and anything else that may be helpful or pertinent.
Examples: Chagas Disease, Fabry Disease, Acne, Common Cold
A “Diseases and Conditions” page”:

  • Includes everything mentioned above for main pages plus at least 8 of the following sections:
    • Other Names
    • Types
    • Signs and Symptoms
    • Causes
    • Diagnosis
    • Treatment
    • Prevention
    • Living with {{PAGENAME}}
    • Chances of Developing {{PAGENAME}}
    • How {{PAGENAME}} is Spread
    • Related Problems
    • Clinical Trials
    • Research
    • Controversy
    • Expected Outcome
    • History
    • Epidemiology
    • Interesting Facts
    • Notable Experts
    • Social Issues
    • Cultural Issues
    • Public Health
    • Other Resources
    • External Links

Symptoms

Symptoms include any ailment that a person may suffer as a result of a larger problem. They describe the symptom, explain to what it could be attributed, and may include treatment specific to that symptom.
Examples: Fever, Pelvic Pain
A “Symptoms” Page:

  • Includes everything mentioned above for main pages plus at least 8 of the following sections:
    • Other Names
    • Causes
    • What {{PAGENAME}} Could Mean
    • Treatment
    • Cures
    • Prevention
    • Research
    • Expected Outcome
    • Other Resources
    • External Links

Drugs

Drugs are any medications that people may take for prevention or (usually) treatment of a condition. The drug’s generic name is always used.
Examples: Ibuprofen, Pemirolast, Antibiotics

A “Drugs” Page:

  • Includes everything mentioned above for main pages plus at least 8 of the following sections:
    • Other Names
    • Uses
    • How {{PAGENAME}} Is Taken
    • How It Works
    • How the body affects {{PAGENAME}}
    • Benefits
    • Side Effects
    • Risks and Precautions
    • Interactions
    • History
    • Controversy
    • Alternatives
    • Statistics
    • Research
    • Clinical Trials
    • Interesting Facts
    • Other Resources
    • External Links

Organizations

Articles on organizations describe any group that functions in and contributes to matters relating to medicine, the body and public health.
Examples: World Health Organization, Centers for Disease Control and Prevention (CDC)

An “Organizations” Page:

  • Includes everything mentioned above for main pages plus at least 8 of the following sections:
    • Mission
    • Summary of Activities
    • Additional Responsibilities
    • History
    • Organizational Structure
    • Other Notable People
    • Publications
    • Statistics
    • Controversies
    • References
    • External Links

Organisms

Describes organisms that are known to affect humans, either in a harmful or helpful way, listing both basic information on the organism as well as ways in which it interacts with the human body, effects, and what can be done to treat/promote health.
Examples include Mycobacterium leprae; Ehrlichiosis and Anaplasmosis, Ebola, Onchocerciasis

An “Organisms” page:

  • Includes everything mentioned above for main pages plus at least 8 of the following sections:
    • Other Names
    • Types
    • Effect on Humans
    • Microbiology
    • Identification and diagnosis
    • Treatment
    • Living with {{PAGENAME}}
    • Research
    • Controversy
    • History
    • Habitat
    • Global Impact
    • Interesting Facts
    • Notable Experts
    • Cultural Issues
    • Public Health
    • Other Resources
    • External Links

Procedures

The “Procedures” pages detail tests, surgeries and other procedures that medical professionals conduct to diagnose and/or treat conditions.
Examples include: Coronary Artery Angioplasty, Colonoscopy, Deep Brain Stimulation

A “Procedures” page:

  • Includes everything mentioned above for main pages plus at least 8 of the following sections:
    • Other Names
    • Description
    • Why {{PAGENAME}} Is Done
    • Types
    • Preparation
    • How {{PAGENAME}} Is Done
    • Benefits
    • Risks
    • Side Effects
    • Effectiveness
    • Recovery
    • Expected Outcomes
    • Statistics
    • Alternatives
    • Experts on {{PAGENAME}}
    • Research
    • Clinical Trials
    • Controversy
    • Interesting Facts
    • History
    • Other Resources
    • External Links

Anatomy and Physiology

Anatomy and Physiology pages describe parts and systems of the body, including information on their structure, associated conditions, medical professionals who specialize in treating those parts/systems, and other pertinent information.
Examples include Hormonal System, Circulatory System, Lungs, Cornea

An “Anatomy and Physiology” page:

  • Includes everything mentioned above for main pages plus at least 8 of the following sections:
    • Other Names
    • Types
    • Description
    • Role of {{PAGENAME}} in the Body
    • How It Works
    • Diseases of the {{PAGENAME}}
    • Related Professions
    • History
    • Research
    • Other Resources
    • External Links

Vitamins and Supplements

Vitamins and Supplements pages discuss specific vitamins and minerals the body needs as well as packaged supplements that deliver those vitamins and minerals.
Examples include: Vitamin A, Chromium, Zinc

A “Vitamins and Supplements” page:

  • Includes everything mentioned above for main pages plus at least 8 of the following sections:
    • Other Names
    • How {{PAGENAME}} Works
    • Sources
    • Benefits
    • Recommended Daily Intake
    • Risks
    • Alternatives
    • Research
    • Clinical Trials
    • Controversy
    • History
    • Experts
    • Interesting Facts
    • Other Resources
    • External Links

Herbs

The “Herbs” pages discuss natural therapies.
Examples include: Cranberry, Echinacea, Cat’s Claw

An “Herbs” page:

  • Includes everything mentioned above for main pages plus at least 8 of the following sections:
    • Other Names
    • Uses
    • Sources
    • How {{PAGENAME}}Is Taken
    • How It Works
    • Risks
    • Research
    • Clinical Trials
    • Controversy
    • History
    • Alternatives
    • Experts
    • Interesting Facts
    • Other Resources
    • External Links

Helpful Hints

Easy Way to Link to Abstracts

Herb Information

http://www.mskcc.org/mskcc/html/11570.cfm]

Biography Links

  • One way to link to biographies of scientists (usually under the "history" section when describing how a drug or condition was discovered): perform a search for the person's name and take a look at the results to find a site that has few pop-ups, ads, etc. and gives a good bio. One good site if they've won a Nobel prize (as many have) is Nobelprize.org. Another source is NNDB.

Interesting Facts

  • If diseases also occur in animals, you can mention that fact under "Interesting Facts."

Digging Up Synonyms

  • This is a great site to find synonyms for the "Other Names" section.

Reading Level Estimation With MS Word

  • Microsoft Word can help estimate the reading level of your writing. If you have the text in a Word document (it doesn't have to be saved), go to Tools - Options - Spelling & Grammar and click on the "Show readability statistics" checkbox. The F7 key invokes the algorithm and you can see if you're in the ballpark for readability.

Resources

  • Health Sciences Online is a great new resource to help you find references and sources for any pages you write. It is a search engine with 50,000 courses, references, guidelines, and other free, and ad-free health sciences resources, reviewed and selected by their staff.
  • Haz-Map, through the NIH, is "an occupational toxicology database designed to link jobs to hazardous job tasks which are linked to occupational diseases and their symptoms. It is a relational database of chemicals, jobs and diseases." It is all in the public domain and can therefore be used on Medpedia.