Difference between revisions of "Guide to Contributing to Wikistation"

From Space Station 13 Wiki
Jump to navigation Jump to search
m (Subcategory to help make the Tutorial category more manageable to navigate)
m (updated links to powering the station)
 
(13 intermediate revisions by 2 users not shown)
Line 1: Line 1:
==New? Create an account first ==
== Making an Account ==
At the moment, editing Wikistation 13 is restricted to registered forum users only. Please [http://forum.ss13.co/member.php?action=register sign up] and get started today!
Guest editing/editing without an account has been disabled. Fortunately, making an account is easy! Thanks to some ingenuous coding on the server backend, if you've made a forum account, you have a wiki account too, so you can start editing once it's activated. Registering a forum account is simple. All you need is an email address for verification. At no point will you need to join the Goonstation Discord or connect to a SS13 server; in fact, you don't even need a BYOND account. Please [http://forum.ss13.co/member.php?action=register sign up here] and get started today!
 
== Don't know wikicode? That's okay, you can still help. ==
 
If you want to learn wikicode, it's an extremely simple language to learn. If not, that's fine - the wiki will accept HTML code as well. Don't know HTML? Simply click on the "discussion" link at the top of a page and leave your comments there. Someone more comfortable with wiki editing will make the necessary changes.
 
=== But wikicode will help me score chicks! ===
 
Indeed it will. For more information on wikicode and wiki editing in general, please see the [[wikipedia:Help:Wiki_markup|wikicode primer]].
 
== Well, that's done. Where do I start? ==


==How to Help==
More than anything else, this wiki needs constant updates to content. Since Goonstation 13 changes so quickly, information can rapidly become out of date, and many things don't even have a page or a picture yet. When there's a new item, role, station, or monster on the station, do your part by simply adding a new page and jotting down what you know about it.
More than anything else, this wiki needs constant updates to content. Since Goonstation 13 changes so quickly, information can rapidly become out of date, and many things don't even have a page or a picture yet. When there's a new item, role, station, or monster on the station, do your part by simply adding a new page and jotting down what you know about it.
If you want to work on a new page uninturrupted by other editors, or simply want to experiment with wikicode, try using [http://wiki.ss13.co/index.php?title=Special:Mypage/Sandbox&action=edit&redlink=1|your personal sandbox page].
=== Content Revisions ===
=== Content Revisions ===


Line 25: Line 13:


Again, if you're uncomfortable editing the page itself, add a note to the talk page, and someone else will add the information to the article.
Again, if you're uncomfortable editing the page itself, add a note to the talk page, and someone else will add the information to the article.
====Regarding Add to Wiki Tags====
Some pull requests on the Goonstation Github are tagged "add to wiki". That means the wiki should be updated to reflect the changes enacted by the PR '''after''' it is merged. It doesn't have to be the person/people who made the PR; it can be just about anybody. It does not mean someone has to update the wiki before the PR can be merged either; it's simply a tool to help wiki editors keep track of changes, rather than a requirement for contributors. Think about it; if the wiki is supposed to document current content, it doesn't make sense for it to describe things that aren't even in the game yet.


=== [https://en.wikipedia.org/wiki/Help:Minor_edit Minor Edits]===
=== [https://en.wikipedia.org/wiki/Help:Minor_edit Minor Edits]===
Line 36: Line 28:
Many pages across the wiki are [[Special:WantedFiles|missing images]]. To help, simply [[Special:Upload|upload the file]] and add a short description to help us keep track of what it is. Please don't forget the description - it can be as short as "Fire Extinguisher," and is a tremendous help.<br>
Many pages across the wiki are [[Special:WantedFiles|missing images]]. To help, simply [[Special:Upload|upload the file]] and add a short description to help us keep track of what it is. Please don't forget the description - it can be as short as "Fire Extinguisher," and is a tremendous help.<br>
<b>NOTE:</b> if you're going to be uploading pictures, make sure you're keeping everything in the native resolution or non-stretched (32x32, 64x64)! The actual dimensions of the image don't matter, but we would prefer it to be as small as possible, especially if it'll go into [[Foods and Drinks]], which doesn't play well with big images. Transparency is good too, but not really required!
<b>NOTE:</b> if you're going to be uploading pictures, make sure you're keeping everything in the native resolution or non-stretched (32x32, 64x64)! The actual dimensions of the image don't matter, but we would prefer it to be as small as possible, especially if it'll go into [[Foods and Drinks]], which doesn't play well with big images. Transparency is good too, but not really required!
=== Don't Know Wikicode? You Can Still Help ===
Simply click on the "discussion" link at the top of a page and leave your comments there. Someone more comfortable with wiki editing will make the necessary changes. If you're on the [https://discord.gg/zd8t6pY official Goonstation Discord] and have access to the #imwiki channel, you can also drop your request there.
==Content Guidelines==
=== The funny stuff (HONK) ===
While most useful contributions to the wiki are content updates, a large portion of the revisions are simply changes to jokes. The [[Roles]] page's jokes change very often and generally get worse with each revision. When making such a change, please consider whether your joke is actually funnier than the one already posted on the site. Please also keep in mind that the primary purpose of this wiki is to provide new players with information about the game; though some entertainment is always appreciated.
When writing guides, please do not attempt to teach new players through sarcasm. Adding a phrase such as "The more people you kill as security, the more points you get with admins" to the [[Security Officer]] page will often cause new readers to think it's actually true. While the readers who have played the game will understand that to be wrong, it's often difficult to convey sarcasm through writing.
You are also welcome to add good SS13-related [[Fan Art|fan art]] and [[Fan Videos|videos]]!
=== Style ===
The general tone of the Goonstation wiki can be described as "business casual". You should be polite and respectful, but it's also perfectly acceptable to use slang and crack jokes.
Avoid using first-person point of view (POV). Instead, use second-person or third-person. While other wikis might allow but discourage second-person POV, it's perfectly fine on the Goonstation wiki, since it's very difficult to write instructions (like those on the [[Construction]] or [[Thermoelectric Generator]] pages) without it.
While Goonstation uses a mix of American and British English spellings, American English ones are most common. Therefore, the Goonstation wiki should be written in American English, e.g. "armor" rather than "armour", "color" rather than "colour".
==Useful Resources==
=== Learning Wikicode and HTML ===
If you want to learn wikicode, it's an extremely simple language to learn. [https://www.mediawiki.org/wiki/Help:Formatting MediaWiki's Help:Formatting article] is the definite wikimarkup reference list, and [[Wikipedia:Help:Wiki_markup]] works as well.
If not, that's fine - the wiki will accept HTML code as well. W3 Schools has a [https://www.w3schools.com/html/default.asp decent reference book] on HTML.
=== Practice ===
You wanna do some stuff but don't want to ruin someone else's 'well crafted' page? Well whaddya wanna work on? [http://wiki.ss13.co/index.php?title=Special:Mypage/Sandbox&action=edit&redlink=1|A new page?] [[:template:sandbox|Your very own template?]] A simple table? You can delete, edit, change, redo, undo, burn, spit on, knock out, fuck up, shit on or do generally whatever you want on any of these pages. Just remember than anyone else can do that too, so don't expect any content to stay there for too long.


=== Templates ===
=== Templates ===
Line 51: Line 75:
Categorization templates (inserts a table linking to pages of the same category, often used at bottom of page, usually automatically places page in a certain category, meaning you don't have to add <nowiki>[[Category:...]]</nowiki> yourself):
Categorization templates (inserts a table linking to pages of the same category, often used at bottom of page, usually automatically places page in a certain category, meaning you don't have to add <nowiki>[[Category:...]]</nowiki> yourself):
* &#123;&#123;[[Template:Game Mechanics|Game Mechanics]]&#125;&#125; - Add to pages that detail broad mechanics that would be useful for almost everyone, e.g. [[Murder]], [[Game Modes]]. Doesn't place page in any category.  
* &#123;&#123;[[Template:Game Mechanics|Game Mechanics]]&#125;&#125; - Add to pages that detail broad mechanics that would be useful for almost everyone, e.g. [[Murder]], [[Game Modes]]. Doesn't place page in any category.  
* &#123;&#123;[[Template:Department Guides|Department Guides]]&#125;&#125; - Add to pages that explain mechanics to particular a job or set of jobs, e.g. [[Guide to Genetics]], [[Powering the station]]. Places page in [[:Category:Tutorials]].  
* &#123;&#123;[[Template:Department Guides|Department Guides]]&#125;&#125; - Add to pages that explain mechanics to particular a job or set of jobs, e.g. [[Guide to Genetics]], [[Power Grid]]. Places page in [[:Category:Tutorial]].  
* &#123;&#123;[[Template:Objects|Objects]]&#125;&#125; - Add to pages with tables that list various items and/or machines, e.g. [[Syndicate Items]], [[General Objects]]. Places page in [[:Category:Objects]].  
* &#123;&#123;[[Template:Objects|Objects]]&#125;&#125; - Add to pages with tables that list various items and/or machines, e.g. [[Syndicate Items]], [[General Objects]]. Places page in [[:Category:Objects]].  
* &#123;&#123;[[Template:Locations|Locations]]&#125;&#125; - Add to pages with tables that describe an in-game location, usually on a certain map, e.g. [[Bar]], [[Arrivals]]. Places page in [[:Category:Locations]].  
* &#123;&#123;[[Template:Locations|Locations]]&#125;&#125; - Add to pages with tables that describe an in-game location, usually on a certain map, e.g. [[Bar]], [[Arrivals]]. Places page in [[:Category:Locations]].  
Line 61: Line 85:
* &#123;&#123;[[Template:main|main|*]]&#125;&#125; – add this at the top of sections to indicate the main page of a topic, where <code>*</code> is replaced with the target page.
* &#123;&#123;[[Template:main|main|*]]&#125;&#125; – add this at the top of sections to indicate the main page of a topic, where <code>*</code> is replaced with the target page.
* &#123;&#123;[[Template:Key|key|*]]&#125;&#125; – use this template to represent individual key presses, where <code>*</code> is replaced with the name of the key.
* &#123;&#123;[[Template:Key|key|*]]&#125;&#125; – use this template to represent individual key presses, where <code>*</code> is replaced with the name of the key.
* &#123;&#123;[[Template:Quote|quote|1|2]]&#125;&#125; – use this template for quotes, where <code>1</code> is replaced with the quote, and <code>2</code> is replaced with the author (if not, defaults to Unknown).
* &#123;&#123;[[Template:Yes|yes]]&#125;&#125; or &#123;&#123;[[Template:No|no]]&#125;&#125; or &#123;&#123;[[Template:N/a|n/a]]&#125;&#125; – use these templates in tables where the value is a simple boolean or not applicable. Optionally, add a <code>|</code> after the template name followed by your desired text instead of the template name.
* &#123;&#123;[[Template:Yes|yes]]&#125;&#125; or &#123;&#123;[[Template:No|no]]&#125;&#125; or &#123;&#123;[[Template:N/a|n/a]]&#125;&#125; – use these templates in tables where the value is a simple boolean or not applicable. Optionally, add a <code>|</code> after the template name followed by your desired text instead of the template name.
* &#123;&#123;[[Template:Missing Value|Missing Value]]&#125;&#125; - use this template to indicate data that is defined but missing from the wiki. Optionally, add a <code>|</code> after the template name followed by your desired text instead of the template name (for example, <code>|?</code> is useful in very tight spaces such as tables).
* &#123;&#123;[[Template:Help|help]]&#125;&#125; or &#123;&#123;[[Template:Disarm|disarm]]&#125;&#125; or &#123;&#123;[[Template:Grab|grab]]&#125;&#125; or &#123;&#123;[[Template:Harm|harm]]&#125;&#125; – use these templates to indicate ingame intents. Optionally, add a <code>|</code> after the template name followed by your desired text instead of the template name.
* &#123;&#123;[[Template:Help|help]]&#125;&#125; or &#123;&#123;[[Template:Disarm|disarm]]&#125;&#125; or &#123;&#123;[[Template:Grab|grab]]&#125;&#125; or &#123;&#123;[[Template:Harm|harm]]&#125;&#125; – use these templates to indicate ingame intents. Optionally, add a <code>|</code> after the template name followed by your desired text instead of the template name.
* &#123;&#123;[[Template:OXY|OXY]]&#125;&#125; or &#123;&#123;[[Template:TOX|TOX]]&#125;&#125; or &#123;&#123;[[Template:BURN|BURN]]&#125;&#125; or &#123;&#123;[[Template:BRUTE|BRUTE]]&#125;&#125; – use these templates to indicate damage type (case sensitive). Optionally, add a <code>|</code> after the template name followed by your desired text instead of the template name.
* &#123;&#123;[[Template:OXY|OXY]]&#125;&#125; or &#123;&#123;[[Template:TOX|TOX]]&#125;&#125; or &#123;&#123;[[Template:BURN|BURN]]&#125;&#125; or &#123;&#123;[[Template:BRUTE|BRUTE]]&#125;&#125; – use these templates to indicate damage type (case sensitive). Optionally, add a <code>|</code> after the template name followed by your desired text instead of the template name.


== The funny stuff (HONK) ==
=== Content Lists ===
 
While most useful contributions to the wiki are content updates, a large portion of the revisions are simply changes to jokes. The [[Roles]] page's jokes change very often and generally get worse with each revision. When making such a change, please consider whether your joke is actually funnier than the one already posted on the site. Please also keep in mind that the primary purpose of this wiki is to provide new players with information about the game; though some entertainment is always appreciated.
 
When writing guides, please do not attempt to teach new players through sarcasm. Adding a phrase such as "The more people you kill as security, the more points you get with admins" to the [[Security Officer]] page will often cause new readers to think it's actually true. While the readers who have played the game will understand that to be wrong, it's often difficult to convey sarcasm through writing.
 
There are several pages intended simply for a laugh: [[Pubbie Tears]] and [[Dumb Pubbies]], for instance. When possible, please keep your jokes there and leave them out of guides. You are also welcome to add good SS13-related [[Fan Art|fan art]] and [[Fan Videos|videos]]!
 
== Useful pages ==
 
'''[[SS13 Wiki:Current events|Current projects]]'''


'''Categories:''' [[Special:Categories|Used]], [[Special:UnusedCategories|unused]] and [[Special:WantedCategories|wanted]]
'''Categories:''' [[Special:Categories|Used]], [[Special:UnusedCategories|unused]] and [[Special:WantedCategories|wanted]]
Line 86: Line 102:


'''Tagged for editing:''' [[:Category:Outdated|Outdated pages]], [[:Category:Candidates for deletion|Candidates for deletion]], [[:Category:WIP|Works in progress]]
'''Tagged for editing:''' [[:Category:Outdated|Outdated pages]], [[:Category:Candidates for deletion|Candidates for deletion]], [[:Category:WIP|Works in progress]]
== Practice? ==
You wanna do some stuff but don't want to ruin someone else's 'well crafted' page? Well whaddya wanna work on? [http://wiki.ss13.co/index.php?title=Special:Mypage/Sandbox&action=edit&redlink=1|A new page?] [[:template:sandbox|Your very own template?]] A simple table? You can delete, edit, change, redo, undo, burn, spit on, knock out, fuck up, shit on or do generally whatever you want on any of these pages. Just remember than anyone else can do that too, so don't expect any content to stay there for too long.
----
----
{{Community}}
{{Community}}
[[Category:Contribution Tutorials]]
[[Category:Contribution Tutorials]]

Latest revision as of 15:57, 21 November 2022

Making an Account

Guest editing/editing without an account has been disabled. Fortunately, making an account is easy! Thanks to some ingenuous coding on the server backend, if you've made a forum account, you have a wiki account too, so you can start editing once it's activated. Registering a forum account is simple. All you need is an email address for verification. At no point will you need to join the Goonstation Discord or connect to a SS13 server; in fact, you don't even need a BYOND account. Please sign up here and get started today!

How to Help

More than anything else, this wiki needs constant updates to content. Since Goonstation 13 changes so quickly, information can rapidly become out of date, and many things don't even have a page or a picture yet. When there's a new item, role, station, or monster on the station, do your part by simply adding a new page and jotting down what you know about it.

Content Revisions

There are almost always large sections of the wiki that have become out of date - the coders simply update too quickly for us to keep up! We keep a central to-do-list to keep track of what still needs to be done.

Before removing the {{outdated}} tag, be sure to read the page and any comments on the discussion page. Once that's done, simply update the parts that are out-of-date with the new information! If the information on the page has been moved to or deprecated by another page on the wiki, simply replace the page's content with #REDIRECT [[New page name]] to help users to find the new information. Remember to match the capitalization on the link.

In addition, be sure to leave a short note in the "Summary" field above the "Save Page" button so the administrators don't mistake your edits for vandalism. It doesn't have to be very detailed. Something like "More Spy Thief bounties" or "Add a tip on Blob starting locations" is fine, and it helps people looking through Recent Changes and a page's history quickly know what's changed between revisions.

Again, if you're uncomfortable editing the page itself, add a note to the talk page, and someone else will add the information to the article.

Regarding Add to Wiki Tags

Some pull requests on the Goonstation Github are tagged "add to wiki". That means the wiki should be updated to reflect the changes enacted by the PR after it is merged. It doesn't have to be the person/people who made the PR; it can be just about anybody. It does not mean someone has to update the wiki before the PR can be merged either; it's simply a tool to help wiki editors keep track of changes, rather than a requirement for contributors. Think about it; if the wiki is supposed to document current content, it doesn't make sense for it to describe things that aren't even in the game yet.

Minor Edits

Likewise, there's plenty of pages that could use style revisions, links to helpful resources, formatting fixes, and other small changes that don't add any content but improve the page nonetheless. As with all writing, there's always room for revisions.

Unlike with content updates, you don't have to consult with the talk page or anything like that. Just make the changes you want, make sure the "This is a minor edit" button is checked as a small courtesy, as always, include a brief description of the changes you've made in the "Summary" field.

Images

Many pages across the wiki are missing images. To help, simply upload the file and add a short description to help us keep track of what it is. Please don't forget the description - it can be as short as "Fire Extinguisher," and is a tremendous help.
NOTE: if you're going to be uploading pictures, make sure you're keeping everything in the native resolution or non-stretched (32x32, 64x64)! The actual dimensions of the image don't matter, but we would prefer it to be as small as possible, especially if it'll go into Foods and Drinks, which doesn't play well with big images. Transparency is good too, but not really required!

Don't Know Wikicode? You Can Still Help

Simply click on the "discussion" link at the top of a page and leave your comments there. Someone more comfortable with wiki editing will make the necessary changes. If you're on the official Goonstation Discord and have access to the #imwiki channel, you can also drop your request there.

Content Guidelines

The funny stuff (HONK)

While most useful contributions to the wiki are content updates, a large portion of the revisions are simply changes to jokes. The Roles page's jokes change very often and generally get worse with each revision. When making such a change, please consider whether your joke is actually funnier than the one already posted on the site. Please also keep in mind that the primary purpose of this wiki is to provide new players with information about the game; though some entertainment is always appreciated.

When writing guides, please do not attempt to teach new players through sarcasm. Adding a phrase such as "The more people you kill as security, the more points you get with admins" to the Security Officer page will often cause new readers to think it's actually true. While the readers who have played the game will understand that to be wrong, it's often difficult to convey sarcasm through writing.

You are also welcome to add good SS13-related fan art and videos!

Style

The general tone of the Goonstation wiki can be described as "business casual". You should be polite and respectful, but it's also perfectly acceptable to use slang and crack jokes.

Avoid using first-person point of view (POV). Instead, use second-person or third-person. While other wikis might allow but discourage second-person POV, it's perfectly fine on the Goonstation wiki, since it's very difficult to write instructions (like those on the Construction or Thermoelectric Generator pages) without it.

While Goonstation uses a mix of American and British English spellings, American English ones are most common. Therefore, the Goonstation wiki should be written in American English, e.g. "armor" rather than "armour", "color" rather than "colour".

Useful Resources

Learning Wikicode and HTML

If you want to learn wikicode, it's an extremely simple language to learn. MediaWiki's Help:Formatting article is the definite wikimarkup reference list, and Wikipedia:Help:Wiki_markup works as well.

If not, that's fine - the wiki will accept HTML code as well. W3 Schools has a decent reference book on HTML.

Practice

You wanna do some stuff but don't want to ruin someone else's 'well crafted' page? Well whaddya wanna work on? new page? Your very own template? A simple table? You can delete, edit, change, redo, undo, burn, spit on, knock out, fuck up, shit on or do generally whatever you want on any of these pages. Just remember than anyone else can do that too, so don't expect any content to stay there for too long.

Templates

To simplify organization and consistency, we have some simple templates that you can use in pages:

Message templates (for use at the top of pages or sections):

  • {{delete}} – add this tag to any page you find that has no reason to exist.
  • {{outdated}} or {{Wip|Reason=}} – add either tag to any page that needs an update due to changes in Goonstation 13.
  • {{pic}} – add this tag to any page that needs a picture.
  • {{Warning|Notes=}} – use this tag to add a warning.
  • {{Historical|Notes=}} – add this tag for pages about discontinued content. The |Notes= section is optional, but can be helpful for disambiguations.
  • {{Transcript|Notes=}} – add this tag for transcripts of ingame content. The |Notes= section is optional.

Categorization templates (inserts a table linking to pages of the same category, often used at bottom of page, usually automatically places page in a certain category, meaning you don't have to add [[Category:...]] yourself):

Other templates:

  • {{main|*}} – add this at the top of sections to indicate the main page of a topic, where * is replaced with the target page.
  • {{key|*}} – use this template to represent individual key presses, where * is replaced with the name of the key.
  • {{quote|1|2}} – use this template for quotes, where 1 is replaced with the quote, and 2 is replaced with the author (if not, defaults to Unknown).
  • {{yes}} or {{no}} or {{n/a}} – use these templates in tables where the value is a simple boolean or not applicable. Optionally, add a | after the template name followed by your desired text instead of the template name.
  • {{Missing Value}} - use this template to indicate data that is defined but missing from the wiki. Optionally, add a | after the template name followed by your desired text instead of the template name (for example, |? is useful in very tight spaces such as tables).
  • {{help}} or {{disarm}} or {{grab}} or {{harm}} – use these templates to indicate ingame intents. Optionally, add a | after the template name followed by your desired text instead of the template name.
  • {{OXY}} or {{TOX}} or {{BURN}} or {{BRUTE}} – use these templates to indicate damage type (case sensitive). Optionally, add a | after the template name followed by your desired text instead of the template name.

Content Lists

Categories: Used, unused and wanted

Templates: Used, unused and wanted

Files: All, unused and wanted

All pages: All existing pages and Wanted pages.

Tagged for editing: Outdated pages, Candidates for deletion, Works in progress


Community
Contributing Guide to Contributing to Wikistation · Goonstation Development Guide · Goonstation Contributor Guidelines · Spriting · Goonstation Spriting Guidelines · Coding · Goonstation Code Guide · Hosting a server · Mapping · Goonstation Map Submission Guidelines · Goonstation Audio Guidelines · Contributing to Requisitions
Members Admins
Culture & Art Terminology · Storyline (Old Storyline) · Basic Lore · Fan Videos · Fan Art
History & Happenings Changelog · Pre-2016 Changelog · History of SS13
Tales & Humor Sex and the Singularity · Maintenance Doggs · The Rapper · The Trial of Heisenbee · Albert and the Deep Blue Sea · The uWu Interrogation · HeadSurgeon · Tales of The Devil‎ · IT'S ALIVE! It died. IT'S ALIVE! It died. IT'S ALIVE!‎ · The floor is now explosions‎ · My god, it's full of butt · The Crashwich · The Doom Peel‎ · Jugglemancy‎