Help:Tutorial

Welcome to the MEpedia tutorial! We hope you find this guide 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!

Still have 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.

Note: The email function is currently not working, so don't worry if you don't receive an email confirmation of your new account.

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.

Review the 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 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.

Warning: The Visual Editor may have difficulty when working with very long pages. If you experience problems using the Visual Editor on a very long page, see MEpedia:Visual editor.

To learn how to use the Source Editor, please see our Source Editor user guide.

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) If you're using the Visual Editor, click on "Save Changes" in the top-right of the window.
 * 7) In the box marked "Summary:", briefly describe your changes so others know what you've changed and why.
 * 8) If you're using the Visual Editor, you can review your changes before saving them by clicking on "Review your changes".
 * 9) If you're using the Source Editor, you can review your changes before saving them by clicking on "Show changes".
 * 10) Finally, click "Save changes" and you're done!

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" or "edit source" 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.)

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, but note the following:


 * 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 for more info.
 * 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.

Discussion pages
Note that every page has a separate "Discussion page" to discuss potential changes. These pages are also called "Talk pages". 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.

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 simply 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.

Step 3: Fill in your own User Page
MEpedia encourages all new contributors to share a little bit about their self on their User Page, so that other contributors can get to know you, fostering a sense of community. Everyone has their own user page, which is named "User:" followed by their login id. (e.g. "User:Pyrrhus") 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.

Warning: Your user page may be visible to the public, so just share what you are comfortable sharing with the public.

Step 4: Review other's changes
Being an MEpedia contributor is about more than just making changes. It is also about constructively reviewing other people's changes. In a collaborative enterprise like MEpedia, contributors spend time making changes, reviewing changes, and discussing issues with other contributors.

Review recent changes
In the sidebar on the lefthand side of your screen, you will find a link entitled "Recent changes". Clicking this link brings up a list of all the most recent changes made to any MEpedia page. Some of those changes will be marked with an "N", which means that it is a new page. Some of those changes will be marked with an 'm', which means it is a minor change. For more information on minor changes, see MEpedia:Minor edits.

Use a watchlist to review changes
A "watchlist" is a personal list of pages that you are interested in. 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 as well.)

Once you've started your watchlist, you'll be able to view all recent changes contributors make to pages you're interested in by clicking "Watchlist" on the top right of your screen. When someone makes a new change to a page on your watchlist, it will show up in bold in the list of changes on your watchlist page. To see what has changed, just click on the word “diff” or the word “changes” on that line. If you then want to see a list of all the pages on your watchlist, including the ones that haven't changed, click on the small link called "View and Edit Watchlist" at the top of the watchlist page.

For more information on watchlists, see MEpedia:Watchlist.

Review the history of a page

 * 1) Choose any MEpedia page, and click on the 'View History' tab at the top of the window.
 * 2) You will see a list of all changes to the page, showing the date, time, user, and a brief description.
 * 3) To see what has changed between two different versions, you can select the two version by clicking on the corresponding circles, then click on the 'Compare Selected Revisions' button.  This will show a side-by-side comparison of the old text and the new text.
 * 4) Be aware that it's possible to 'undo' an edit if something has gone drastically wrong.  Ask someone at the Editor Help Desk to do this for you.

For other ways to track changes, see MediaWiki's tracking changes 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.

Step 6: 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.

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.

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. See also 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, or the "Upload file" link in the lefthand sidebar. 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, make a note of the exact file name so that you can correctly specify the file name when it comes time to add it to a page.

For information on how to add the image to the page, 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.