This is '''part 1''' of the series of [[RuneScape:Editing#Guides|editing guides]] of the RuneScape Wiki. This guide is a step-by-step process to '''your first edit''' - or, '''how to edit plain text with the visual editor'''.

This guide is made from the perspective of a logged-out user (or a logged-in user with default preferences).

==Walkthrough==
===Spotting an error===
Finding an error to fix can sometimes be hard, but there's definitely things out there to fix - the wiki is far from perfect. (All of the various cleanup categories will be covered in more detail in another guide.)

For now, lets assume you've found a page with something simple to fix. I have found such an example for this demonstration: the experience section of [[heroic skull]] seems pretty poorly worded. I'm going to reword it.

http://i.imgur.com/OXZeRL8.png

===Opening the editor===
Opening the editor is as simple as clicking the Edit button at the top of the page, just below the title.

http://i.imgur.com/e0lC9SN.png

You are now in the editor. It looks like the page, but some bits may move around, and there's an edit toolbar at the top. This editor is called the '''VisualEditor''', and it is a WYSIWYG (what you see is what you get) editor, like any word processor (e.g. Microsoft Word). Feel free to click around and explore the parts of a page and what they look like when left-/right-clicked.

http://i.imgur.com/0Gl9bOU.png

===Editing the page===
I'm now just going to edit the experience section. This bit is just plain text with no additional stuff - so to edit it we just select where to type, and type there. You can select a bunch of letters and delete them, etc. Inserting a new paragraph is as simple as pressing enter.

http://i.imgur.com/WQeNdRz.png

Here's my finished reword - it may not be perfect, it should hopefully be more readable and clear. (I have also added a linebreak to the above section.)

http://i.imgur.com/CXeSeXs.png

===Saving the edit===
Saving an edit done by clicking the 'Save page' button in the right side of the toolbar. (The cancel button adjacent to it cancels your edit (with a warning) and returns you to the normal page view.) Click it to open the save dialog.

http://i.imgur.com/Z1UzTmp.png

In the dialog there's a place to put your edit summary, and three buttons. First, we're gonna check the 'Review your changes' button.

;Reviewing changes

http://i.imgur.com/ZyaMdPS.png

This is the changes shown to you as a 'diff' (which you may be familiar with if you use tools like git). The left column of text (with the green theme) is the currently viewable page, and the right column (with the blue theme) is the text as you've changed it. Lines with something that has changed have a thick left border, and lines with nothing changed are flat grey. Text that has changed (or been removed) is highlighted in green on the left, and the replacement (and new) text is highlighted in blue on the right. This text is in wikicode, which is covered in a later guide in more details.

What we're looking for is twofold: to double check our changes are what we want to do (proofread it), and to see if anything has changed that should not have changed - the VisualEditor has some bugs that can cause it to insert/delete a lot of extraneous text. If this happens to you and you notice, it may be possible to fix it by using source mode (see source mode introduction guide) - however, you might have to start the edit over. Luckily, our edit seems fine so we'll continue.

It is optional but recommended to do this for every edit.

;Saving
Clicking 'Return to save form' brings us back to the previous form. Here we're going to add an edit summary and finally save the page.

http://i.imgur.com/kAe8GmG.png

An edit summary is a comment attached to your edit that isn't visible on the page itself, but it is publicly viewable. You should try to succinctly summarise your edit so that other editors can see what you've done - you can be as brief or descriptive as you like (but bear in mind there's 255 characters available (though some characters can count as more than one)). You can also use wikicode links in edit summaries, if you like.

Edit summaries aren't subject to most style policies/guidelines, but they are subject to community ones, like the [[runescape:user treatment policy|user treatment policy]] (i.e. if you are rude to other users in a summary that is as much grounds for a block as an edit). Edit summaries can't be changed after the fact, only deleted by an administrator (in relatively rare circumstances).

I've gone with a simple "reword".

Now, we just click save. After a short time of submission (don't close/reload the page during this, your edit may be lost if you do!), the edit is saved and the page automatically reloads to show the new page.

http://i.imgur.com/2xKuR7k.png

And that's it! The edit has been saved and is viewable to all.

==Common things to fix and not fix==
There are several simple things you should fix if you see them, for example:
* Typos
* Links to incorrect places
* Incorrect or outdated information
* Poorly-formatted/worded paragraphs

Things you shouldn't change or should otherwise bear in mind:
* The wiki uses [[RS:STYLE#SPELLING|British English spelling and style throughout]] (except when the name of an in-game item or NPC is in American English). This means that:
** Words should be spelled using British English; common examples include "colour" (not "color"), "utilise" (not "utilize"), "dialogue" (not "dialog"), and so on.
** Dates should be in D M Y format, without '-th' qualifiers, for example "26 October 2016", and not "26th October 2016" nor "October 26 2016". (A comma between M and Y is optional, so "26 October, 2016" is also fine.)
** Building floors start at 'zero', where the floor that is level with the ground is the "ground floor" (the American "first floor"), the floor above that is the "first floor" (the American "second floor"), and so on. You may find it easier to use more universal flooring references like "climb to the top floor".
* When referring to in-game items and monsters, unless the name is/includes a proper noun, sentence case should be used - i.e. don't capitalise the monster/item name. "The abyssal whip is dropped by abyssal demons." not "The Abyssal whip is dropped by Abyssal demons."
** Location names are always proper nouns, as are skills. Take care to distinguish between the verb and noun uses of a skill, i.e. "mining runite ore requires level 85 Mining."
* In most prose, abbreviations/acronyms generally should be avoided. Some common examples:
** "experience" not "XP"
** "life points" not "LP"
** "coins" not "GP"
* In certain cases (usually tables), the above abbreviations are fine to use. However, things like "sara gs" are never ok to use. Additionally, if an acronym is used, it should be uppercase. If you're going to use an abbreviation in a section, make sure to define what it means at the start.

You can see more about this in the [[RuneScape:Editing/Policies|policies guide]].

==The next guide==
The next guide in the series is [[RuneScape:Editing/VisualEditor basics]], about using the VisualEditor to edit various other parts of an article. You may prefer to skip straight to source mode with [[RuneScape:Editing/Source mode basics]].

You may also want to read about editing policies at [[RuneScape:Editing/Policies]].

See [[RuneScape:Editing#Guides]] for a list of all guides.