Guide to contributing to the wiki: Difference between revisions

From Yogstation-13
Jump to navigation Jump to search
imported>Oranges
(Clarify public wiki)
(Page rewrite and update)
(3 intermediate revisions by 2 users not shown)
Line 1: Line 1:
== Welcome ==
== Foreword ==


We're happy you've shown interest in contributing to the wiki. This is a quick guide to how you can help
Welcome to the guide for contributing to the Yogstation Wiki - we're happy to have you here. As a first order of business, in order to edit pages on this Wiki, a Yogstation Wiki account is '''required'''. These can be obtained by joining the Yogstation Discord at https://discord.gg/0keg6hQH05Ha8OfO, and making a request in the #Wiki-and-Mentor channel; Wiki staffers with the relevant permissions would be glad to assist in getting an account set up for you (a list of all active Wiki team members can be found [[Wiki_Team|here]]. We welcome all contributors and assume good faith for all edits made, so there are very few protected pages, but Wiki Administrators do patrol changelogs to attempt to combat bad faith attacks or changes, so please be mindful of what you are doing and be ready to justify it if it raises a red flag. Once you've received your account, don't be afraid to jump in and start correcting and adding to pages.
<br>
<br>
== Getting Started ==


== [[Wikicode]] ==
There are a few concepts that drive Wiki functionality, and this guide will attempt to touch on the very basics that you'll need to get in and get going. If you have questions regarding more advanced topics, you can ask in the above mentioned #Wiki-and-Mentor channel of the Yogstation Discord, and Wiki staff will try to help you as they can.


Wikicode is the strange syntax used by all wikipedias including this one. If you don't know it and are prepared to learn, you can read the internal wikicode page [[Wikicode|here]], or read the Wikipedia page [http://en.wikipedia.org/wiki/Help:Wiki_markup here]. If you don't want to spend your life learning this markup, then fret not, you can still help.
=== [[Wikicode]] ===


Wikicode is the syntax used by all Wikipedias, including this one. If you don't know it and are prepared to learn, you can read the internal wikicode page [[Wikicode|here]], or read the Wikipedia page about it [http://en.wikipedia.org/wiki/Help:Wiki_markup here]. It is daunting at first, but once learned the processes become more intuitive, much like coding, which in some regard it is.
These functions are used for the formatting and visual display of information, mainly. Instead of having a page be a long meandering paragraph, Wikicode allows information to be broken up and changed in appearance for greater clarity, such as the section headings shown in this guide. If you aren't able to figure it out on your own, please get in touch with Wiki staffers on the Yogstation Discord - they can attempt to guide you through the process, or potentially take your raw page information and apply formatting to it if you have no interest in Wikicode and merely wish to produce content.
<br>
<br>
== What needs doing? ==
== What needs doing? ==
The Yogstation Wiki is an utterly massive project, and the active Wiki Staff team is small, comparatively. Most everywhere you look there is out-of-date information, duplicate guides, broken links, unintelligible references. The Wiki Team attempts to keep core pages up to date and patrolled, but there are many pages on the periphery in dire need of attention. A good place to start is by analyzing your strengths and the completeness of your knowledge within the context of Space Station 13, and then attempting to revise or update material relevant to that. If you are a person who plays Roboticist every round, then take a moment to look over the [[Roboticist]] page and verify the information there - add tips and tricks that you've picked up; publish a new guide page for some advanced facet of the position - in short, play to your strengths when editing and contributing, otherwise information can be left worse off than when it started.


=== New pages ===
=== New pages ===


New content is constantly being added to ss13 which needs tutorials and such. Before you start to write a page, search for it and if you can't find it, start one yourself. We welcome all contributions to the wiki and trust all edits to be made in good faith. As a recommendation if you wish to work on a page uninterrupted and not worry about other users edits while working, make it in your personal [[Special:MyPage/Sandbox|sandbox]] area or anywhere in your own pages. If you don't know wikicode, you can create a unformatted page and ask someone else to format it for you.
New content is constantly being added to Space Station 13, which requires new tutorials and guides and information. Before you begin a new page, '''please search thoroughly and completely for an existing or similar page to avoid creating duplicate guides or pages'''. If you can't find it or anything related to it, you are clear to start a page yourself! This can be done simply by plugging in the title of the page you would like to create in the Search Bar in the top right - if nothing is found in the Wiki databanks, you will be prompted to create a new page under that title; this will generate a blank page that you can begin formatting and filling in with your information. It is highly recommended that you first assess the type of page you are trying to make, i.e. is it a new guide? is it a new job? and then navigate to pages that exist within that same familial typing and copy the formatting over to your new page. This will save you a lot of work in the end, as well as standardize the formatting across your new page and existing ones of the same type.


=== Content revisions ===
=== Content revisions ===


A list of pages which need revisions can be found [[:Category:Needs revision|here]]
A list of pages which need revisions can be found [[:Category:Needs revision|here]]. Revision flags on Jobs or Guides tend to take highest priority, as these are the pages utilized the most by Wiki visitors.
 
As a recommendation, if you wish to work on a page uninterrupted and not worry about other users editing the same thing while you are working, you can mirror the page in to your personal [[Special:MyPage/Sandbox|sandbox]] area or anywhere in your own pages. This will create a "localized" copy that you can change unfettered by interference by others.


Updates are frequent and we need people to update the information on the wiki. To do this simply edit the page with new information. If you don't know wikicode you can write the new, updated content on the discussion page without formatting.
'''Additionally, if you are revising a page, PLEASE put a summary in the Summary section of your editing window towards the bottom of the page. This will help Wiki Administrators immensely when patrolling new page edits.'''


=== Images ===
=== Images ===


If you have relevant images then upload them and add them to the page they're intended for. It is appreciated if the pictures of items you add have a blank background and are in the .gif or .png format. The easiest way to add images of items is to download the [[Downloading the source code#Downloading|source code]], open the icons .dmi files and export images as .gif's or .png's from there.
If you have image files to attach, you can upload them via the Upload File link on the left toolbar (also accessed by Alt-Shift-U keyboard command), and then add them to the page they're intended for.  
 
=== Marking for revision and deletion ===


If a page is '''up to date''' when you read it, please put the following tag at it's top (with the correct date):
For item images, it is appreciated if the image has a blank background and is in the .gif or .png format.


<code>
For most ingame assets, the easiest way to add images of them is to download the [[Downloading the source code#Downloading|source code]], open the icons .dmi files and export images as .gif's or .png's from there.
<nowiki>{{Lastrevision | date = 15. 1. 2012}}</nowiki><br>
</code>


If a page is '''out of date''' or doesn't have a reason for existing, add one of the following tags to the top of the page:
=== Marking for revision and deletion ===
 
<code>
<nowiki>{{Needs revision}}</nowiki><br>
</code>
<code>
<nowiki>{{Needs revision | reason = Out of date.}}</nowiki><br>
</code>
or<br>
<code>
<nowiki>{{delete}}</nowiki>
</code>
 
==Talk Pages==
When write on a page or user's '''talk page''' (for example [[Talk:Main_Page]]), there are a few things you need to know.
 
===Signature===
Always end of your message with your signature, so everyone knows who wrote what (without checking the edit history).<br>
This can be done easily by using <code><nowiki>~~~~</nowiki></code> after your message. You can customize your signature on your [[Special:Preferences|user preferences page]].
 
{|class="wikitable" style="font-size:90%; border: 2px solid darkgrey" cellpadding="3" cellspacing="0" colspan="2" ||
|-
!Code:
||
<nowiki>Look. ~~~~</nowiki>
|-
!Result:
||
Look. - [[User:Deantwo|Deantwo]] ([[User_talk:Deantwo|talk]]) 10:35, 30 November 2013 (CET)
|}


===Indentation===
If a page is '''out of date''' or doesn't have a reason for existing, add one of the following tags to the top of the page ('''TO COPY THESE TAGS, PLEASE VIEW THE SOURCE CODE OF THIS PAGE'''):
When replying to another user's message, be sure to ''indent'' your message so it is visibly a reply to the above message.<br>
This is done by simply adding <code><nowiki>:</nowiki></code> at the start of the line will cause this effect.


{|class="wikitable" style="font-size:90%; border: 2px solid darkgrey" cellpadding="3" cellspacing="0" colspan="2" ||
'''Needs revision due to being out of date''':
|-
{{Needs revision
!Code:
|reason= REASON}}
||
<br>
<nowiki>Look. - [[User:Deantwo|Deantwo]] ([[User_talk:Deantwo|talk]]) 10:35, 30 November 2013 (CET)</nowiki><br>
'''Flag for deletion:'''
<nowiki>:At what? ~~~~</nowiki>
<br>
{| width="60%" bgcolor="#ff6666" align="center"
|align="center"|[[File:Dead.png]] <font size='4'>'''THIS PAGE HAS BEEN MARKED FOR DELETION'''</font> [[File:Dead.png]]
|-
|-
!Result:
|align="center"|For the following reason: ''{{{1|REASON}}}''. Tagged by: {{{2|NAME}}}[[Category:candidate for deletion|{{FULLPAGENAME}}]]
||
Look. - [[User:Deantwo|Deantwo]] ([[User_talk:Deantwo|talk]]) 10:35, 30 November 2013 (CET)
:At what? - [[User:Deantwo|Deantwo]] ([[User_talk:Deantwo|talk]]) 10:40, 30 November 2013 (CET)
|}
|}
 
<br>
===Headline===
If you are starting a new topic, add a headline with the name of the topic. If a talk page is used a lot, it can become confusing if the topics aren't separated with headlines. It also allows for section editing, which makes editing long talk pages a lot easier.<br>
This is one of the most basic things on a wiki, and are used by typing <code><nowiki>==Topic==</nowiki></code> on the line above your message.
 
{|class="wikitable" style="font-size:90%; border: 2px solid darkgrey" cellpadding="3" cellspacing="0" colspan="2" ||
|-
!Code:
||
<nowiki>==Look at this tutorial==</nowiki><br>
<nowiki>Look. - [[User:Deantwo|Deantwo]] ([[User_talk:Deantwo|talk]]) 10:35, 30 November 2013 (CET)</nowiki><br>
<nowiki>:At what? - [[User:Deantwo|Deantwo]] ([[User_talk:Deantwo|talk]]) 10:40, 30 November 2013 (CET)</nowiki><br>
<nowiki>::This tutorial I made. ~~~~</nowiki>
|-
!Result:
||
<font size="4">Look at this tutorial</font> <nowiki>[</nowiki><span style="color: blue">edit</span><nowiki>]</nowiki>
----
Look. - [[User:Deantwo|Deantwo]] ([[User_talk:Deantwo|talk]]) 10:35, 30 November 2013 (CET)
:At what? - [[User:Deantwo|Deantwo]] ([[User_talk:Deantwo|talk]]) 10:40, 30 November 2013 (CET)
::This tutorial I made. - [[User:Deantwo|Deantwo]] ([[User_talk:Deantwo|talk]]) 10:45, 30 November 2013 (CET)
|}
 
== Jokes ==
== Jokes ==


Some pages are intended to be entertaining but when writing guides, remember that a newbie might not realize something is a joke or sarcasm, even if it's blatantly obvious to the rest of us. Think where jokes fit and where they don't. Also, if you're updating someone else's joke, think whether yours is actually funnier.
Some pages are intended to be entertaining, but when writing guides, please remember that a new player might not realize that something is a joke or sarcasm and will instead take it at face value. For more practical guides, less jokes are better. Where it is more discretionary, please think about where jokes fit and where they don't, and if you are updating someone else's joke, think whether yours is ''actually funnier''.
 
<br>
<br>
== Guide to Writing and Revising a Guide ==
== Guide to Writing and Revising a Guide ==
Always keep in mind what these guides are for; they're so newbies can quickly skim across them so they can have half an idea what they've just been selected for.
Always keep in mind what the guide pages on this Wiki are for. They are so new players can quickly glean relevant information about the role they have chosen, or been chosen for, or about mechanics of the game on the whole.
 
'''A good guide needs, by order:'''
* A brief one-two paragraph description of what the mode is.
* A bullet point list of short to the point key points of key mechanics, these should be no longer than two sentences each. And remember: key points means the important shit you need to know to atleast bumble fuck your way around at round start, you should be able to read and understand it within 5 minutes.
* A more meaty section detailing the game mechanics in depth (this is where you explain what all runes and talismans do, including the ones that are barely used), it should still be clear and concise.
* A summary of the key points, yes - one at the start and one at the end. Reiteration helps to hammer things home. This one will more or less be simple list to remind the reader of things, it wont explain them.
* Further reading - this is where you link to the pages that detail advanced strategies for fighting for and against the cult. No you don't put them on the main page because that will clutter it.
* Links! Remember to add links to [[Game modes|game modes]], [[Guides#Antagonist Guides|antagonist roles]], [[jobs]], items and [[guides]] you mention! Simply do it when you re-read your content before submitting.  
 


A bad guide is one that's a giant wall of text that's overly fluffed up and full of opinionated bullshit.<br>
'''A good guide generally consists of:'''
A newbie is going to take one glance at it and shit their pants out of fright, and advanced player is just going to go "Yeah.... I'm not reading someone's sperg page".
* A brief introduction or overview of what the guide is going to be describing or accomplishing.
* A detailed run down of the various topics mentioned above, with sectioning and sub-sectioning for clarity and ease of access.
* Images and visual information where needed and appropriate.
* Reference links or further reading material to give a grasp of content adjacent or connected to the topic at hand - for example, the Cook job page has links to the Guide to Food and Guide to Drinks, as these are relevant.
* A conclusion which ties together all the above information and seeks to reiterate the material covered prior.


[At the moment]{{citation needed}} [[Guides#Security guides|Security's guides]] are good. [[Space Law]] is unfluffed and tells plainly the basics of what a [[security officer]] needs to know to start patrolling and robusting greyshirts. The [[Guide to security]] is more fleshed out and explains things more in depth and lists strategies to counter antags.<br>
Poorly formatted or written guides can make it hard to convey relevant information and may be discouraging to newer players.
[[Cult]], [[Malf]], and [[Traitor]] are bad because they're giant imposing walls of text that reads like a newspaper: squished up text that obscures the facts with needless opinions and blurbs that you don't need to know off the bat.
 
'''So remember:'''
* Facts good, opinions bad.
* Keep your facts clear of irrelevant fluff and other bullshit.
* Keep the basic guide basic, keep the advanced stuff on a separate page.
* Important stuff first, depth and explanation and unimportant things second.
* White space, tables, sections, and formatting are essential for ease of reading. We're not print media, space isn't at a premium so use it freely.
* Links!
* I just used the above template to write this guide.


'''Extra tips:'''
* Keep your facts correct and as the primary focus.
* If you are writing a basic guide, '''keep it basic''', and put the advanced topics on a separate page.
* Make use of formatting, tables, white space, headings, and other methods to draw attention and give direction to critical points of information
<br>
== Useful pages ==
== Useful pages ==


Line 141: Line 86:


'''All pages:''' [[Special:AllPages|All existing pages]] and [[Special:WantedPages|Wanted pages]]
'''All pages:''' [[Special:AllPages|All existing pages]] and [[Special:WantedPages|Wanted pages]]
 
<br>
== /tg/station wiki specific markup ==
 
To create a BYOND hyperlink, use the <nowiki><byond></nowiki> tags. The specific syntax is <nowiki><byond server=servername.com port=4000>Link text here</byond></nowiki>.
 
The wiki also supports the features of the [http://www.mediawiki.org/wiki/Help:Extension:ParserFunctions ParserFunctions] extension.
 
== Spambot protection - Security question ==
 
To create an account you will need to provide the answer of one of two questions. One being about the game engine (byond) and the other about the chan board (tg). The answers to the questions are in brackets.
 
You will need to provide the answer to the question every time you make an edit as an unregistered user. The question is just above the edit content field.
 
[[Category:Guides]] [[Category:Game Resources]]
[[Category:Guides]] [[Category:Game Resources]]
{{Contribution guides}}
{{Contribution guides}}

Revision as of 13:02, 25 January 2020

Foreword

Welcome to the guide for contributing to the Yogstation Wiki - we're happy to have you here. As a first order of business, in order to edit pages on this Wiki, a Yogstation Wiki account is required. These can be obtained by joining the Yogstation Discord at https://discord.gg/0keg6hQH05Ha8OfO, and making a request in the #Wiki-and-Mentor channel; Wiki staffers with the relevant permissions would be glad to assist in getting an account set up for you (a list of all active Wiki team members can be found here. We welcome all contributors and assume good faith for all edits made, so there are very few protected pages, but Wiki Administrators do patrol changelogs to attempt to combat bad faith attacks or changes, so please be mindful of what you are doing and be ready to justify it if it raises a red flag. Once you've received your account, don't be afraid to jump in and start correcting and adding to pages.

Getting Started

There are a few concepts that drive Wiki functionality, and this guide will attempt to touch on the very basics that you'll need to get in and get going. If you have questions regarding more advanced topics, you can ask in the above mentioned #Wiki-and-Mentor channel of the Yogstation Discord, and Wiki staff will try to help you as they can.

Wikicode

Wikicode is the syntax used by all Wikipedias, including this one. If you don't know it and are prepared to learn, you can read the internal wikicode page here, or read the Wikipedia page about it here. It is daunting at first, but once learned the processes become more intuitive, much like coding, which in some regard it is.

These functions are used for the formatting and visual display of information, mainly. Instead of having a page be a long meandering paragraph, Wikicode allows information to be broken up and changed in appearance for greater clarity, such as the section headings shown in this guide. If you aren't able to figure it out on your own, please get in touch with Wiki staffers on the Yogstation Discord - they can attempt to guide you through the process, or potentially take your raw page information and apply formatting to it if you have no interest in Wikicode and merely wish to produce content.

What needs doing?

The Yogstation Wiki is an utterly massive project, and the active Wiki Staff team is small, comparatively. Most everywhere you look there is out-of-date information, duplicate guides, broken links, unintelligible references. The Wiki Team attempts to keep core pages up to date and patrolled, but there are many pages on the periphery in dire need of attention. A good place to start is by analyzing your strengths and the completeness of your knowledge within the context of Space Station 13, and then attempting to revise or update material relevant to that. If you are a person who plays Roboticist every round, then take a moment to look over the Roboticist page and verify the information there - add tips and tricks that you've picked up; publish a new guide page for some advanced facet of the position - in short, play to your strengths when editing and contributing, otherwise information can be left worse off than when it started.

New pages

New content is constantly being added to Space Station 13, which requires new tutorials and guides and information. Before you begin a new page, please search thoroughly and completely for an existing or similar page to avoid creating duplicate guides or pages. If you can't find it or anything related to it, you are clear to start a page yourself! This can be done simply by plugging in the title of the page you would like to create in the Search Bar in the top right - if nothing is found in the Wiki databanks, you will be prompted to create a new page under that title; this will generate a blank page that you can begin formatting and filling in with your information. It is highly recommended that you first assess the type of page you are trying to make, i.e. is it a new guide? is it a new job? and then navigate to pages that exist within that same familial typing and copy the formatting over to your new page. This will save you a lot of work in the end, as well as standardize the formatting across your new page and existing ones of the same type.

Content revisions

A list of pages which need revisions can be found here. Revision flags on Jobs or Guides tend to take highest priority, as these are the pages utilized the most by Wiki visitors.

As a recommendation, if you wish to work on a page uninterrupted and not worry about other users editing the same thing while you are working, you can mirror the page in to your personal sandbox area or anywhere in your own pages. This will create a "localized" copy that you can change unfettered by interference by others.

Additionally, if you are revising a page, PLEASE put a summary in the Summary section of your editing window towards the bottom of the page. This will help Wiki Administrators immensely when patrolling new page edits.

Images

If you have image files to attach, you can upload them via the Upload File link on the left toolbar (also accessed by Alt-Shift-U keyboard command), and then add them to the page they're intended for.

For item images, it is appreciated if the image has a blank background and is in the .gif or .png format.

For most ingame assets, the easiest way to add images of them is to download the source code, open the icons .dmi files and export images as .gif's or .png's from there.

Marking for revision and deletion

If a page is out of date or doesn't have a reason for existing, add one of the following tags to the top of the page (TO COPY THESE TAGS, PLEASE VIEW THE SOURCE CODE OF THIS PAGE):

Needs revision due to being out of date:

Pen.png This page needs revising!

The following page is out of date and/or needs to be revised. If the page's guide needs revision, see here for an example.
The revision reason is: "REASON"
Marked by: "Unknown"




Flag for deletion:

Dead.png THIS PAGE HAS BEEN MARKED FOR DELETION Dead.png
For the following reason: REASON. Tagged by: NAME


Jokes

Some pages are intended to be entertaining, but when writing guides, please remember that a new player might not realize that something is a joke or sarcasm and will instead take it at face value. For more practical guides, less jokes are better. Where it is more discretionary, please think about where jokes fit and where they don't, and if you are updating someone else's joke, think whether yours is actually funnier.

Guide to Writing and Revising a Guide

Always keep in mind what the guide pages on this Wiki are for. They are so new players can quickly glean relevant information about the role they have chosen, or been chosen for, or about mechanics of the game on the whole.

A good guide generally consists of:

  • A brief introduction or overview of what the guide is going to be describing or accomplishing.
  • A detailed run down of the various topics mentioned above, with sectioning and sub-sectioning for clarity and ease of access.
  • Images and visual information where needed and appropriate.
  • Reference links or further reading material to give a grasp of content adjacent or connected to the topic at hand - for example, the Cook job page has links to the Guide to Food and Guide to Drinks, as these are relevant.
  • A conclusion which ties together all the above information and seeks to reiterate the material covered prior.

Poorly formatted or written guides can make it hard to convey relevant information and may be discouraging to newer players.

Extra tips:

  • Keep your facts correct and as the primary focus.
  • If you are writing a basic guide, keep it basic, and put the advanced topics on a separate page.
  • Make use of formatting, tables, white space, headings, and other methods to draw attention and give direction to critical points of information


Useful pages

Categories: Used, unused and wanted

Templates: Used, unused and wanted

Files: All, unused and wanted

All pages: All existing pages and Wanted pages

Contribution guides
General Hosting a server, Setting up git, Guide to GitKraken, Downloading the source code, Guide to contributing to the game, Reporting issues, Game resources category, Guide to changelogs
Database (MySQL) Setting up the database, MySQL
Coding Understanding SS13 code, SS13 for experienced programmers, Text Formatting
Mapping Guide to mapping, Room Structure, Map merger
Spriting Guide to spriting
Wiki Guide to contributing to the wiki, Wikicode, Styleguide