Difference between revisions of "Contributing to the wiki"
From Outscape Wiki
m (→Basic Editing Tips)
m (Protected "Contributing to the wiki": Protected meta page not intended for use by standard editors ([Edit=Allow only administrators] (indefinite) [Move=Allow only administrators] (indefinite)))
Revision as of 19:45, 9 November 2019
Thinking about helping out with the wiki? This page will get you up to speed and explain how and where to get started. Editors are also encouraged to look through the wiki's Manual of Style for editing tips and page formatting.
Your help needed
This community wiki is for Outscape players and we need your help to improve it. Your contributions are not only valued, but enable us to focus more time on developing new features and making the best game possible!
While members of the Outscape development team participate in maintaining this wiki, it is a community wiki, and we encourage players to get involved however they can. Contributing could be a sentence or two clarifying how something in the game works, amending stats, fixing grammar on a page, uploading an image, a new page about strategies, a gameplay guide – it's up to you.
We'd also love it if players would create some really compelling new player guides, with mini missions such as destroying a pirate fleet or colonizing a second homeworld. We know early game is slow and we are working on that, but often new players don't realize there is actually a lot to do which they are overlooking. We'd be happy to see multiple starter guides in the wiki e.g. "Tim's Syntis Newbie guide".
Overall, don't be afraid to add new content. The biggest problem right now is lack of content!
How to help
Before pages can be edited, new editors must create and verify a Wiki account. An editor's Wiki account is not connected to their forum or game accounts. For ease of communication, new editors are requested to use the same user handles as they do on the forum and in-game, to help people easily find each other.
- Take a look at the pages under the following categories:
- Wanted Pages: pages listed here are linked to by other pages, but don't exist yet and so need to be created.
- Need starting: pages in this category will be empty (possibly with a data table/image only) and in need of at least some basic details added.
- Need expanding: content in this category needs expanding e.g. more points covered, a data table adding, images.
- Need updating: content that could now be outdated or has room for improvement.
- Need verifying: content in this category needs to be verified for accuracy/quality and moved to Need updating if necessary.
- Need images: pages in this category could benefit from one or more new images, or updated versions of existing images.
- Need moving: pages in this category contain useful content that is best hosted elsewhere, such as on the forums or Steam discussion boards.
- Uncategorised Pages and Uncategorised Categories - these pages are not part of any categories, and need to be given a home. (Note that the top-level Wiki category should not be part of any further categories.)
- Validate recent wiki activity (click the diff/hist to see what changed)
- Improve existing pages.
- Correct grammar mistakes and inaccurate content, and clean up pages in accordance with the Manual of Style.
Basic Editing Tips
The basic editing tips are meant for the casual editor who plans on adding some information to the Outscape Wiki. Following these guidelines will ensure that your contribution will require little or no follow up edits.
- Before editing, check that your information is factual. Hypotheticals and unverified information should never be on the wiki and are best discussed on the forums.
- You can start editing an article by clicking on the edit link in each section, or by clicking on the Actions --> Edit tab on the top-right of the page. Whenever possible, choose to edit a small section of a page instead of the full page. This is useful when working on long pages. If a page requires edits in multiple sections, it may be useful to edit each section individually to keep track of your work.
- After finishing the edit, do not click save yet. First, make sure you check your edit visually using the "Show Preview" button. Check spelling, grammar, formatting, and links to assure they are correct and working.
- If you are lost in your own edit, you can click on the "Show Changes" button to see the work you have done.
- Make sure to include an Edit Summary of the work you have done. It is the textbox located above the buttons. This will provide other editors with info on the work done, and helps keep the page history organized.
- Tick the minor edit box if the information you have added is trivial, or edits involve minor issues such as grammar, spelling, existing link fixes, etc.
- Only after going through the steps 3 to 6, should you then proceed with a save.
Interested editors should read the Manual of Style for more information.
- Checking the recent page history for past edits is usually a good idea. If the last edit introduced too many errors or will be difficult to correct, then it is easier to perform an "Undo" instead and start a fresh edit.
- When performing an undo, make sure to include the reason for the reversion in the edit edit summary.
Discussing this wiki
Discussion and Talk Pages
Individual articles have Discussion pages, which can be used to discuss or leave notes for individual pages. Similarly, Wiki users have Talk pages, which can be used for editors to leave messages for one another. Each user can also create a User page, which is their space to edit freely. Most users prefer that it is left for their own work, such as a personal introduction or list of things they are working on.
Some additional guidelines for edits to User and User:Talk pages:
- Avoid editing another User's page - this is considered very poor etiquette. Talk pages of other Users may be edited in order to leave them messages.
- When making a new comment on a User:Talk page, it may be helpful to use a section tag using "== A Section Tag ==" by adding 2 equal characters at the front and back of the section header, to create a discussion topic.
- If you are giving a reply, don't forget to indent it accordingly, as shown in the example below. This is done by adding a ':' colon mark for each level of indent.
- Lastly, don't forget to sign your comments. This can be done easily by adding four tildes (~~~~) at the end of the comment.
The Outscape forum has an area for discussing this wiki. Please post there if you need help with anything, have any suggestions for this wiki, or wish to discuss something with fellow wiki contributors.
Things you should definitely do
To make the Wiki the best it can be, editors are encouraged to follow these pointers:
- Make User and Talk pages - this will let other editors see who you are and make you contactable if needed.
- Use article Discussion pages - to co-ordinate edits on individual articles, editors are encouraged to leave any relevant notes and requests on the Discussion pages of articles, where they can be easily seen, discussed and marked as complete when appropriate.
- Provide Edit summaries - this is so other editors can more easily track and verify recent edits.
- Know your admins - also called sysops in MediaWiki parlance, these are a special class of user, able to delete, restore and protect pages, as well as block vandals. A list of current admins may be found here.
- Use proper formatting in text/links - this makes the Wiki more readable for both users and editors. For guidance on this, see the Manual of Style.
- Use categories - these are important for organising and grouping related articles together; every article should be a member of at least one category. Every category is also a member of at least one category, ultimately leading back to the master Wiki category. The category tree may be viewed here.
- Keep to encyclopedic style - a formal and dispassionate tone should be used throughout articles, but player-written guides can (and should!) be more conversational in tone. Both Wikipedia and the MediaWiki documentation have excellent guidance on this.
Things you should not do
The following lists some basic things that you should not be adding or doing on the Outscape Wiki:
- Deliberately inserting false information. This will lead to a block.
- Advertising third-party applications. Spam accounts which do this will be blocked, as above. Individual links to Twitch, Discord, etc. should be posted to the forums instead.
- Adding fan theories or conjecture. Such content is generally not appropriate for Wiki entries, but may be posted over at the forum.
- Adding fan requests or submissions. While an important part of testing and development, making requests on the Wiki will not be widely visible to other players and/or community managers, and is not in keeping with the Wiki's purpose of documenting mature and confirmed future content. These should instead be made on the forums to facilitate discussion.
- Leave "To-Do" notes/info requests on a page. These should not be left in the bodies of articles, as they disrupt the overall flow and are not easily visible to other editors, who may be able to action these points. Editors should instead use the Discussion pages of articles for this. Info requests may also be made at the Wiki section of the forum in order to reach more players.
- Make multiple consecutive edits to a page. This spams the Recent changes page and makes it more difficult for editors to monitor changes, especially if they are minor and incremental. Wherever possible, aim to finish your work in one or two edits by making use of the "Show Preview" function. Be sure to mark changes as minor if they do not represent significant changes to content. Always mark changes to your own User and My Talk pages as minor.
As Outscape remains in Alpha testing with a small potential editor base, vandalism is highly unlikely. Any concerns over malicious editing should be brought to the attention of the wiki admins via private message.
Editors can read up on wiki etiquette here: Wikipedia:Wiki etiquette. In short, be polite and civil to other editors, and they will do the same.
Beyond this, Wikipedia contains lots of information for the interested editor. Some of the more useful and relevant links: