Help:Wiki Editing Style Guide

This is an introductory guide to contributing to the Wiki. It will describe what should be Wiki'd, how to do so, and what a good Wiki article should contain. This is a very important thing to read, if you aren't familiar with the Wiki concept. Also of note is Welcome to Wiki Syntax, which is all about how you do different things in a Wiki.

First of all, know that you are very strongly encouraged to contribute to the Wiki - this resource is only as useful as we make it! There is no reason for anyone to be shy about editting a page and sharing some insights - this is very helpful to us all.

Never worry about "breaking" the Wiki - there's nothing you can do that can't easily be fixed. There are several people who check the Recent Changes page regularly, and they'll fix any mistakes you've made.

That said, never expect anything you write on the Wiki to remain as you wrote it - it completely defeats the purpose of the Wiki if there is anything that can't be rewritten, expanded upon, and improved. By the same token, you should feel free to edit anything you see here.

Always remember that this Wiki is about modding Oblivion - all the information here should be about helping us all make better mods, and all information on making better mods should be here. Keep contributions relevant, and contribute everything relelvant that you know and we don't. That way, we can create the ultimate Oblivion modding resource possible!

Wiki Ettiquette & Style

This is a public place, 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 editted, 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 civilly, 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 - this is the manual to modding, and we want it to look slick and serious. Grammar and spelling are important, and so is accuracy. People invest a lot of time and effort into modding - incorrect information here can cause many people a lot of headaches. Please, keep your contributions neat, accurate, and avoid posting your own opinion - this is a guide to explaining how to do things, not an editorial on a given tool or an advertisement for a particular mod.

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

There are, of course, exceptions to that rule. There are a lot of discussion pages here, where we need to know who is saying what, and sometimes a contribution should be attributed to someone so users will know who to contact with questions (this is often true of tutorials and the like). When to sign and when not to sign are left to your discretion. It is usually pretty obvious when a signature is appropriate and when it is not.

The Summary Bar, Minor & Major Edits

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

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

Collaboration

Finally, the single most important aspect of a Wiki is that it brings together the knowledge of all so that everyone can learn everything about modding. 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!

The Community Here at TESCS Wiki

The people here are friendly, helpful, and absolutely want you to join us! If you would like to join here, contribute, and help maintain the Wiki, then you'll get along just fine. If you just want to learn something, that's OK too! It is, afterall, what we are here for. But we encourage everyone to sign up, to create a User Page, and to check out the Recent Changes - see what's happening! Add your opinion to discussions, make some articles better, and have a good time - that's what this Wiki is about.

User Pages

Your User Page can be found at http://cs.elderscrolls.com/constwiki/index.php/User:YOUR_USER_NAME - write something in it! It's great for experimenting with Wiki syntax, and for telling us all a little about yourself. People may also leave you messages in your User Talk page - this is a great way to ask about other people, to ask questions of some of our very experienced modders, or to thank someone for making a great contribution to the Wiki!

Talk Pages

Talk pages are where all the behind-the-scenes stuff happens in a Wiki. Sometimes you think something should be changed in an article, but aren't sure how - ask in the Talk page, and see what people think! Other times, maybe you think you've found a new trick or have some tips you'd like to add, but you don't know for sure that it will always work - suggest it in the Talk page, and see if others like the idea!

Always sign your contributions to discussions - it makes it very difficult to Talk if you don't know who you are talking to. Sign your post with ~~~~, which will insert your name (as a link to your user page), and the date and time you made the edit.

Also, when responding to someone, use :'s at the beginning of each paragraph to indent the paragraph, so it's easier to see who said what. Take a look at a few Talk pages, and this will make sense.

User Lists

By adding yourself to the appropriate User Lists, you let us know a bit about yourself. It's a great way to start here at the Wiki!

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 Welcome to Wiki Syntax! Check that out if you have any questions!