Help:Tutorial

Welcome to the MEpedia Tutorial! We hope you find this tutorial clear and easy to follow. Take it step-by-step, a little bit at a time, and you will be an MEpedia expert in no time!

Have any questions after reading through the tutorial? Ask for help at our MEpedia editor help desk or email [mailto:mepedia@meaction.net mepedia@meaction.net]. (Since volunteer availability can vary greatly, please do not be offended if it takes some time to receive a response.)

Create an account
Before you start editing, you should create an account or log in. Please note: if you are not logged in when you make an edit or contribution to a page, your IP address will be visible in the page history of each entry you edit. (Note that the email function is currently not working, so don't worry if you don't receive an email confirmation of your new account.)

Review the Rules and Guidelines
Please make sure to review the following rules and guidelines before you begin editing:
 * Editorial Guidelines
 * Science Guidelines
 * MEpedia:Manual of Style

Get to know the two types of editors
There are two types of editor on this wiki, the Visual Editor, which operates more like your word processing or email program, and the Source Editor, which uses a special kind of wiki code, called "wikitext". Most users will prefer to use the Visual Editor, but for more advanced applications, or if the Visual Editor is "down" (as happens from time to time), this tutorial will help you learn how to navigate both.

To learn how to use the Visual Editor, please see Wikipedia's Visual Editor user guide. Also see MEpedia:Visual_editor. Note that the Visual Editor includes a facility to automatically insert full citations, by just specifying the link or DOI to the source; see Visual Editor Auto-filled Web Citations.

The Source Editor is a more advanced way of editing MEpedia. See our tricks and tips on how to get started with the source code editor. For more information on the wikitext used in the Source Editor, see Mediawiki's wikitext help.

Basic editing workflow

 * 1) Go to the Sample Page.  This is a safe place to practice editing without having to worry about messing up a real page.
 * 2) First familiarize yourself with any outstanding issues by clicking on the Discussion tab at the top of the window.
 * 3) Switch back to the Sample Page.
 * 4) Click on the "Edit" (Visual editor) or "Edit source" (Source editor) links at the top of the window, (to edit the whole page) or click on the "edit" link next to each section heading (to edit just that section).
 * 5) Make your changes.
 * 6) After you've made your changes, scroll down to the "Show Preview" section, add a comment, preview your changes, then save them.

Adding links, citations, and Template tags
While editing a page, you should be on the lookout for improvements that can be made to the existing text. Often these improvements come in the form of links, citations, or Template tags. You may already be familiar with adding links and citations.

To insert a Template tag in the Visual Editor, click on "Insert" at the top of the window and select "Template". Then type in the name of the Template tag (e.g. "Citation needed", "Cleanup", or "Stub") and click "Add Template".

To insert a Template tag in the Source Editor, simply type the name of the Template tag inside double braces. For example,  or   or.

If you see a word in the page that already has an MEpedia page, make it a link to that page. If you see a statement that should have a citation, you can tag it with the "Citation needed" Template tag. If you find a page that needs a significant cleanup, you can tag it with the "Cleanup" Template tag.

Remember that articles must use strong citations. For example, if you write, "ME/CFS can be successfully treated with XYZ", you MUST provide a reference to evidence, ideally a high quality (randomized, placebo-controlled) published study. If there is no evidence, the wording must reflect this, for example, "ME/CFS is sometimes treated using XYZ, but currently there is no good evidence for its use".

Other considerations
Note that every page has a separate "Discussion" page to discuss potential changes. For example, the page for Virus has a discussion page named Talk:Virus. If you're unsure of an edit you're planning to make on a particular MEpedia entry, you can discuss the issue with other contributors on the entry's discussion page. To learn how to do this, see MEpedia:Discussion.

Tip: Only edit one section of a page at a time, and then save your changes. This way, you're less likely to encounter an "edit conflict" if someone else happens to be editing the same page at the same time. To do this, scroll down to the section you want to edit, and then click "edit" next to the section's title. Save your changes often. (If another person ends up editing the same section at the same time, then you may be asked to 'merge' your changes with theirs.)

For more information on editing pages, see MediaWiki's editing help.

First pick a name for the new page
The first step to creating a new page is to pick a name for your page. To safely practice creating a new page, pick a page named "User:" followed by your user name. (e.g. "User:Pyrrhus" for a user named Pyrrhus) This "User Page" is a safe space for you to practice creating a new page.

Note that a "Namespace" is simple a prefix to a page name that categorizes a page. Most pages will have no prefix. User pages are named with the "User:" namespace. Pages relating to the MEpedia project itself should be named with the "MEpedia:" namespace, such as in MEpedia:Administrators. (The Visual Editor is not currently available in the "MEpedia:" namespace.)

Normally, you'd first want to search the existing database of pages to make sure that your page or a similarly named page does not already exist.

Create a blank page
Simply type in the name of your new page in the box below and click "Create Page."

Fill the blank page with an Article Outline
Once you've created a new, blank page, you should use an existing 'Article Outline', instead of trying to write a page from scratch. This must be done in the Source Editor, not the Visual Editor. Find the best outline in the List of Article Outlines and then copy and paste the outline into your blank page. At that point, you can switch back to the Visual Editor if desired.

Place your new page in the right Categories
Categories are a way of grouping related pages together based on content. A single page can belong to multiple categories. All pages should be placed in the most appropriate categories. To get an idea of which categories your page should belong to, browse through similar pages and observe the categories listed at the very bottom of the pages. To view a list of all categories, see Special:Categories.

To change the categories of a page using the Visual Editor, click on the 'Page Options' link represented by three horizontal bars towards the top-right of the screen. Click on 'Categories'. If you see an inappropriate category listed, you can remove that category by clicking on the garbage can icon for that category. You can then type the name of any new category into the empty box labelled 'Add a Category'. Finally, click 'Apply Changes'.

To change the categories of a page using the Source Editor, simply scroll down to the end of the page, where the categories are listed. To add a new Category, add to the end of the page. Be sure to remove any inappropriate categories listed.

For more information on categories, see MediaWiki's Categories help.

Finally, save your new page
After you've finished creating your new page, scroll down to the "Show Preview" section, add a comment, preview your changes, then save them.

Stubs, Redirects, and Disambiguation pages
If you have created a new page, but don't have the time to fully complete the page, you can mark the page as a "Stub". A Stub is a page that has been created, but is not yet completed. Simply add the Template tag "Stub" to your page. For more information, see MEpedia:Stub.

If the name of your new page has multiple spellings or other synonyms, you should provide a way for people to find your page when they search for these other versions. You do this by creating 'Redirect pages', which direct users to your page from other spellings or synonyms. For details on how to do this, see MEpedia:Redirect.

If the name of your new page could be confused with a different page, a ‘Disambiguation page’ may be required. A Disambiguation page is a separate page that lists the pages with similar names, so that the user can pick which page they really intended to see. See MEpedia:Disambiguation for more info.

Fill in your own User Page
Everyone has their own user page, which is named "User:" followed by their login id. (e.g. "User:Pyrrhus") This user page is where you describe a little bit about yourself, so that other contributors can get to know you. To access your user page, just click on your login id at the top of the page. For more information on MEpedia user pages, see MEpedia:User page. For more information on user pages in general, see MediaWiki's User Page help.

First warn people
Renaming a page is also called 'moving' a page. Before renaming/moving a page, make sure that others are aware of the move. It is good to propose the move in the Discussion page and give people a month's notice or so.

Fix links to the page
Right before you rename the page, you should replace any links to the old name with links to the new name. To find any pages that link to the page, go to the page and click on "What links here" in the lefthand sidebar, under 'Tools'. Make sure you type the new name correctly, or else you might introduce a broken link!

Rename the page
When you're ready to rename the page, simply click on the 'More' tab at the top of the window, and select 'Move'. Replace the old name with the new name in the appropriate box. Describe the reason for the move in the box labeled "Reason:". Finally, click on the "Move page" button.

Check for double redirects
Be aware that after the move, the old name will then be a redirect page linking to the new renamed page. When you're done fixing the links so that they point to the new name, make sure that there are no redirect pages that point to another redirect page. (This is called a 'double redirect'.)

Keep or delete the old name
Finally, delete the old name redirect page, if necessary. In many cases, it will be a good idea to keep the redirect page around so that people can still find the page using the old name.

For more information on renaming/moving a page, see WikiMedia's moving pages help.

How to delete a page
To delete a page, simply add the category "Articles for deletion"" to the page. This officially marks the page for deletion.  An Administrator will periodically review the category to perform the final deletion, as only administrators can perform the final deletion.

Template Tags
The following table lists the most important Template tags you may need to use.

Five minute tasks
Only have a five-minute spoon to give? Here is a list of small tasks you can help us with in roughly one to ten minutes of time.

Priority projects
Want to dive in deeper? Browse a list of larger projects and page revisions.

Implement a suggestion
If you want to contribute but aren't sure where to start, try looking at the MEpedia:Suggested tasks and consider implementing a suggested improvement.

Make a suggestion
If you have a suggestion for improving MEpedia but you are unable to implement it yourself, you can go to the MEpedia:Suggested tasks page, click Edit, and add your suggestion to the list for someone else to consider implementing in the future. Please bear in mind that many volunteers working on MEpedia are sick, some bed-bound. Given the constraints this introduces, any improvements to MEpedia that you are able to implement yourself are greatly appreciated. Be bold! Together we are stronger as a community. And if you just need help getting started making your improvement, feel free to leave a note at the MEpedia editor help desk requesting assistance.

Start a watchlist and review changes
Browse through MEpedia to find articles you're interested in--for instance, through the Contents page. When you find an interesting page, click the star icon at the top of the page to add it to your watchlist. Editing a page usually adds it to your watchlist. Once you've started your watchlist, you'll be able to view all changes contributors make to pages you're interested in by clicking "Watchlist" on the top right of your screen. Some of those changes will be marked with a 'm', which means it is a minor change. For more information on watchlists, see MEpedia:Watchlist. For more information on minor changes, see MEpedia:Minor edits.

Create a new article
To create a new article, simply search for the title of the article you wish to create. If a page does not already exist, you will see an option to create the page. Alternatively, if you see a red link to the page, that means it does not yet exist. Just click the red link to create the page. You can also browse our list of "wanted" pages – pages that are linked to from existing pages, but don't yet exist. These appear as red links in the encyclopedia.

Expand a page
Pages that have been created (blue links) but need to be expanded are marked as "stubs" - a full list of all stubs can be found here. For more information, see MEpedia:Stub. Pages that are unusually short can be found in Special:ShortPages; these also need to be expanded. We also have a list of priority pages for expansion.

Add an image
Many of our pages could be improved simply through the addition of images and drawings. It's important to make sure you have permission to use any photos you add, that they are in the public domain, or that they carry a Creative Commons license. See this category of articles that need images or photos added to them: Category:Articles that need an image or photo. Best practices for attribution via Creative Commons.

Before an image can be added to a page, the image must first be uploaded to MEpedia using the Special:Upload page. First check to make sure that the image hasn't already been uploaded to MEpedia by searching with Special:FileDuplicateSearch or by looking through the list of images in Special:ListFiles.

Once the file has been uploaded to MEpedia, the image can be added to a page using the visual editor. For information on how to add an image, see MEpedia:Images and/or Help:IMAGE.

Add a chart or graph
See MEpedia:Graph.

Fix redirects
Sometimes a page will redirect the viewer to a page that doesn't exist. These redirects need to be removed or fixed. To see a list of these broken redirects, see Special:BrokenRedirects. A double redirect is when a page redirects to another page, which itself redirects to a third page. This should not happen. To see a list of double redirects that need fixing, see Special:DoubleRedirects.

Add a video
Videos can be put at the top of a page using the EmbedVideo code.  Autoplay should be turned off. Example:

For more information, see MEpedia:Video.

Check our references
You can make sure facts are properly cited and references are in the correct format. We aim to serve a general audience, a research audience, and a patient audience. All entries should be cited and should make clear to distinguish what has and has not been established by peer-reviewed research findings. Articles should aim to provide both a general overview of a specific topic as well as discuss its implications or applications in ME and CFS.

To see a list of pages that have been marked with the "Citation needed" template tag, see Category:All articles with unsourced statements.

A reference to an external website that no longer works is called a "dead link". See MEpedia:Dead_links for more info.

Check our categories
We try to maintain all pages within a logical hierarchy of categories and subcategories. However, the names and types of categories are constantly changing and some pages are missing categories. You can help by making sure that pages are assigned to the correct categories. To see which categories a page belongs to, just look at the bottom of the page. To view a list of all categories, see Special:Categories. To see which pages are lacking a category, see Special:UncategorizedPages.

Correct typos and links
You can also copy-edit existing articles for typos and edit for clarity. If you see a word that should be linked to an MEpedia page, make the first use of that word on the page a link to the corresponding MEpedia page. For more information on such links, see MEpedia:Internal_links. To see a list of all pages that don't yet have any links, see Special:DeadendPages.

A link to an external website that no longer works is called a "dead link". See MEpedia:Dead_links for more info.

A page that is not linked to by any other page is called an “orphaned page”. See MEpedia:Orphaned_pages for more info.

Tip: Note that, in the Source Editor, a link to a category page must start with a colon ":", for example. If you forget the initial colon, your page will be added to that category instead!

Mark pages as needing cleanup
If you see a serious problem with a page and you are not able to resolve it, mark the page as needing a cleanup by adding a "Cleanup" Template tag, including a description of the problem and the date.

If you are using the Source Editor, the Template tag will look something like this:  

Mark spam for deletion
If you see a page that's obviously spam or otherwise needs deleting, you can add the category Articles for deletion to that page. Before you do that, first acquaint yourself with the concepts in MEpedia:Vandalism.

Clean-up poor pages
Some pages are inconsistently formatted, too long, are presented badly, need partially rewriting, or suffer from other problems. Those pages are marked as needing clean-up, and are listed under Category:All articles needing cleanup.