OSRune Wiki:Handbook

## **Wiki Etiquette & Style**

This is a public wiki, and so we all have to get along here. There are several ways to help that happen.

## **Keeping Things Civil**

The most important thing is to never take things personally. Your contributions will be edited, changed, perhaps even removed - it's all for the sake of making this guide as useful as possible, none of it is ever meant personally.

That doesn't mean that you always have to agree with an edit someone else has made. Every page in this Wiki has a Talk page for this purpose - it's a convenient place to discuss possible changes to the page in question. If you think an edit was made that shouldn't have been, bring it up in the Talk page. If you make a particularly large change to an article, start a discussion of it in the Talk page, explaining why you've made the changes you did. Communication makes a community, and if we all discuss things civilised, we'll always be on good terms here.

## **Making a Professional Looking Guide**

One of the most important things about this Wiki is that it should look professional. Grammar and spelling are important, and so is accuracy. People invest a lot of time and effort into putting correct information about **OSRune** on the wiki, and incorrect information can therefore cause many people a lot of headaches.

**Please, keep your contributions neat, accurate, and avoid posting your own opinion.**

## **Concept of Ownership**

This also means not signing articles. This is a group effort, and we're working to help others, not to gain credit for how much effort we put in or to show off how much we know.

On the other hand, it is very important to sign discussions, be they in talk pages, or general discussions pages. This allows everyone to know who is saying what and makes conversations flow much more smoothly.

## **The Summary Bar**

When you edit a page, you will be given a box in which to type a summary - please make use of it! These summaries appear on the Recent Changes page, and allow us to know what you edited.

Under this, there is a checkbox for a Minor edit - Minor edits are typo fixes, formatting changes, and spelling corrections - any and all additions or changes to the content of a page should never be marked minor. If in doubt, leave it unchecked - it's better for someone to check a Minor edit than for someone to miss a Major edit!

## **The Greatness of a Wiki**

The Wiki format is absolutely perfect for this endeavor! There are three things about Wikis that make them incredibly useful when utilized properly:

### **Links**

Wiki articles should be full of links. This is the Internet - nothing should be isolated. Wikis are designed to allow and encourage the use of internal links - an article should link to many other relevant articles. Every time you use a term which has further info on it - link to the article (it is not necessary to link to the same article over and over, of course). An article on setting up a quest will undoubtedly talk about NPCs at some point - and at that point, it should link to an article about how you make your own NPCs.

In general, huge, scratch-to-finish guides should be avoided on the Wiki - keep articles short and focussed, and if it is a part of a process, link to the next step. This allows people to find information far more quickly, without having to scrounge through a long article. It also makes it easier to link to a given piece of information if it's not part of a huge mega-article.

### **Categories**

All pages on the Wiki should be in one or more Categories - it makes them much easier to find. Remember, you don't just want users to find your article - you want them to be able to find all the information they need, and the easiest way for them to do that is if things are categorized together neatly.

This is another reason why articles should be short and focused - Categories show the title of an article, and if you have a large article that covers a lot of topics, it's impossible to write a succinct title that will let users know everything you have in that article. If you split up the article into separate articles for each topic, users will be able to find exactly what they are looking for just by reading the titles.

### **Collaboration**

Finally, the single most important aspect of a Wiki is that it brings together the knowledge of all so that everyone can learn from eachother and work together. Without contributions from everyone, the Wiki cannot be all it could be - this is your official invitation to contribute to the Wiki in every way you can!

## **Style Don'ts**

**Some specific rules on style (how to write pages):**

#### **​Don't use colons in page titles**

Colons are used in wiki to designate namespaces (e.g. User:, Template:, etc.). While the article will generally behave correctly, it's best not to tempt fate.

#### **​Don't Repeat the Page Title**

The page title is automatically displayed at the top of the page (effectively as a level one header). Hence the title should not be repeated at the beginning of the page text.

#### **Don't use First or Second Person**

Don't be chatty. Don't talk about "I" or "you". Just present the info in straightforward, concise fashion from the third person. Does this make it hard to write tutorials? Yes. Don't write tutorials. We already have enough.

#### **Don't Submit Useless Information**

Keep in mind that the point of the wiki is to communicate information that is likely to be useful to readers of the wiki. (Note the "likely".) I.e. don't describe some clever script that your wrote at length -- unless doing will likely be instructive to a good number of readers. If it will be useful, then trim it down to the bare bones that illustrates the information that you're trying to communicate.

## **Conclusion**

Now you have a pretty good idea what the Wiki is all about, and you're ready to start contributing yourself!

But if you don't know Wiki syntax, that can be a pretty daunting task. For that reason, we also have the Wiki Editing Syntax Guide! Check that out if you have any questions!

Regards, the   **Wiki Team**