Difference between revisions of "Kerbal Space Program Wiki:Guidelines"

From Kerbal Space Program Wiki
Jump to: navigation, search
(Grammar correction)
m (Reverted edits by Rocketing Rudolph (talk) to last revision by Peteletroll)
(22 intermediate revisions by 5 users not shown)
Line 1: Line 1:
{{Box|Notice.svg|At the moment the content was only added by [[User:XZise]] and [[User:Ruedii]] so it is likely far from complete may not the official opinions of the other admins}}
+
{{Box|Notice.svg|At the moment the content was only added by [[User:XZise|xZise]] and [[User:Ruedii|Ruedii]], so it is likely far from complete and may not reflect the opinions of the other admins.}}
 
These guidelines help you in writing good articles and maintaining a consistent style with already existing ones.
 
These guidelines help you in writing good articles and maintaining a consistent style with already existing ones.
  
Line 7: Line 7:
 
* '''Use common sense''': Generally the phrasing should use minimal point of view, and should phrasing. Unlike Wikipedia, game perspective is fine, but other obvious rules still persist.Try to avoid expressing things in manners that may be considered offensive, and make sure all content is related to Kerbal Space Program in one manner or another.
 
* '''Use common sense''': Generally the phrasing should use minimal point of view, and should phrasing. Unlike Wikipedia, game perspective is fine, but other obvious rules still persist.Try to avoid expressing things in manners that may be considered offensive, and make sure all content is related to Kerbal Space Program in one manner or another.
 
* '''Give other users the benefit of the doubt''': It's generally a good idea to presume best intentions unless there is no way that good intentions could be presumed. This reduces arguing. It is simple to fix a mistake, but you won't do a good job of it if you are presuming the other person was making the mistake intentionally.
 
* '''Give other users the benefit of the doubt''': It's generally a good idea to presume best intentions unless there is no way that good intentions could be presumed. This reduces arguing. It is simple to fix a mistake, but you won't do a good job of it if you are presuming the other person was making the mistake intentionally.
 +
 +
=== Linking to other articles ===
 +
It is recommended to link without changing the link text (aka only with <nowiki>[[link target]]</nowiki>) with suffixes. Also when linking parts the name shouldn't be hidden. Either use the general page or the part name, so a visitor can always see, what is meant. So instead of “''All [[Command module|command modules]] except the [[EAS-1 External Command Seat|one]] have torque.''” (source code: <code>''All <nowiki>[[Command module|command modules]]</nowiki> except the <nowiki>[[EAS-1 External Command Seat|one]]</nowiki> have torque.''</code>) it should be rewritten as “''All [[command module]]s except the [[EAS-1 External Command Seat]] have torque.''” (source code: <code>''All <nowiki>[[command module]]s</nowiki> except the <nowiki>[[EAS-1 External Command Seat]]</nowiki> have torque.''</code>). Because the first character is always uppercase a link to ''Command module'' doesn't differ to ''command module'', but doesn't apply to any other character. For example ''cOmmand module'' won't link to ''Command module''.
  
 
== Naming articles ==
 
== Naming articles ==
 
=== Kerbal Space Program specific content ===
 
=== Kerbal Space Program specific content ===
Content from Kerbal Space Program, like the celestial bodies and parts should be named like the official naming ingame. The only exception at the moment is [[Kerbol]] which is officially called the [[Sun]] (see also [[Talk:Kerbol#Name|discussion about naming Kerbol]]). The official name of Parts could be retrieved by looking into the ''part.cfg'' of the part.
+
Content from Kerbal Space Program, like the celestial bodies and parts should be named like the official naming ingame. The only exception at the moment is [[Kerbol]] which is officially called the [[Sun]] (see also [[Talk:Kerbol#Name|discussion about naming Kerbol]]), and [[Kerbonaut]] which is never used in-game while "astronaut" is (see also [[Kerbonaut#Naming]] and [[Astronaut Complex]]). The official name of Parts could be retrieved by looking into the ''part.cfg'' of the part.
  
 
If an object in KSP get renamed, like the [[Inline Clamp-O-Tron]] (previously ''Hull-mounted Clamp-O-Tron''), the old name redirect to the current name.
 
If an object in KSP get renamed, like the [[Inline Clamp-O-Tron]] (previously ''Hull-mounted Clamp-O-Tron''), the old name redirect to the current name.
Line 17: Line 20:
 
General articles like [[aerobraking]] should use the common English capitalization: Only names begin with an uppercase character. The same applies to linking where most articles should start with a lowercase character (if they aren't a name).
 
General articles like [[aerobraking]] should use the common English capitalization: Only names begin with an uppercase character. The same applies to linking where most articles should start with a lowercase character (if they aren't a name).
  
== Linking to Wikipedia ==
+
== Linking ==
 +
=== Linking to parts ===
 +
When linking to a part, it is recommended not to hide the link target. So when it links to a part directly the link text shouldn't be the type of part. For example instead of <tt><nowiki>[[FL-T100 Fuel Tank|liquid fuel tank]]</nowiki></tt> either <tt><nowiki>[[liquid fuel tank]]</nowiki></tt> or <tt><nowiki>[[FL-T100 Fuel Tank]]</nowiki></tt>. This helps readers to see what the link is about and, depending on the situation, if a statement is applying to the specific part linked or to all similar parts. For example the following sentence which hides the link target can be misleading:
 +
:''The '''LV-T30 Liquid Fuel Engine''' uses fuel from [[FL-T100 Fuel Tank|liquid fuel tank]]s.''
 +
An inexperienced user may think there is only one liquid fuel tank or the LV-T30 only works with the FL-T100. Instead it should be written in one of the two ways:
 +
:''The '''LV-T30 Liquid Fuel Engine''' uses fuel from tanks like the [[FL-T100 Fuel Tank]].''
 +
:''The '''LV-T30 Liquid Fuel Engine''' uses fuel from [[liquid fuel tank]]s.''
 +
There is a third option, if there is no general article about the part type. This applies for example for the EAS-4 Strut Connector: There is no article strut but instead it redirects to the part page, which unfortunately hides the link target even further. But has the advantage that the links don't need to be changed, if in the future additional struts are available and there is a dedicated article about them.
 +
 
 +
=== Linking to Wikipedia ===
 
It is possible to link to an Wikipedia article with using the <nowiki>[[</nowiki> and <nowiki>]]</nowiki>. For example Kerbal Space Program in the English Wikipedia:
 
It is possible to link to an Wikipedia article with using the <nowiki>[[</nowiki> and <nowiki>]]</nowiki>. For example Kerbal Space Program in the English Wikipedia:
 
* <code><nowiki>[[w:Kerbal Space Program|Kerbal Space Program]]</nowiki></code> generates [[w:Kerbal Space Program|Kerbal Space Program]]
 
* <code><nowiki>[[w:Kerbal Space Program|Kerbal Space Program]]</nowiki></code> generates [[w:Kerbal Space Program|Kerbal Space Program]]
Line 25: Line 37:
 
* <code><nowiki>[[de:Kerbal Space Program|Kerbal Space Program]]</nowiki></code> does not work and generates a red link [[de:Kerbal Space Program|Kerbal Space Program]]
 
* <code><nowiki>[[de:Kerbal Space Program|Kerbal Space Program]]</nowiki></code> does not work and generates a red link [[de:Kerbal Space Program|Kerbal Space Program]]
  
Usually a <code>w:</code> as a prefix followed by a prefix from the Meta-Wiki does work. All available interwiki links are shown at [[Special:Interwiki]] and lists also non Wikimedia related projects.
+
Usually a <code>w:</code> as a prefix followed by a prefix from the Meta-Wiki does work. All available interwiki links are shown at [[Special:Interwiki]] and lists also non Wikimedia related projects. The [[metawikipedia:Help:Piped_link#Pipe_trick|pipe trick]] helps linking need to write the target twice:
 +
* <code><nowiki>[[w:Kerbal Space Program|]]</nowiki></code> generates [[w:Kerbal Space Program|Kerbal Space Program]]
  
=== Linking to forum/blog ===
+
=== Linking to other project resources ===
To link to the official Kerbal Space Program forum or blog it is possible to use the prefixes <code>thread</code> and <code>blog</code>. It is not possible to link to a specific post (yet) with <code>thread</code>. The bug tracker IDs can be linked with <code>bug</code>.
+
To link to the official Kerbal Space Program forum or blog it is possible to use the prefixes <code>thread</code> and <code>blog</code>. It is not possible to link to a specific post (yet) with <code>thread</code>. The bug tracker IDs can be linked with <code>tracker</code>.
  
* <code><nowiki>[[blog:184|KSP 0.21 Update News]]</nowiki></code> generates [[blog:184|KSP 0.21 Update News]]
+
* <code><nowiki>[[blog:321|Flags]]</nowiki></code> generates [[blog:321|Flags]]
* <code><nowiki>[[thread:23902|Saving an Assembly]]</nowiki></code> generates [[thread:23902|Saving an Assembly]]
+
* <code><nowiki>[[article:184|KSP 0.21 Update News]]</nowiki></code> generates [[article:184|KSP 0.21 Update News]]
* <code><nowiki>[[bug:787|Bug #787]]</nowiki></code> generates [[bug:787|Bug #787]]
+
* <code><nowiki>[[thread:12406|Show off your awesome KSP Pictures]]</nowiki></code> generates [[thread:12406|Show off your awesome KSP Pictures]]
 +
* <code><nowiki>[[tracker:787|Bug #787]]</nowiki></code> generates [[tracker:787|Bug #787]]
  
 
== Moving and deleting pages ==
 
== Moving and deleting pages ==
Only [[Help:User_rights|sysops]] can move or delete any pages. To delete a page simply add {{Tlx|Delete|reason}}, as blanking the page won't simply hide the content, but it is still available through the version history. It is only recommended to delete the page if it is a spam pages which links to external sites, as this prevents search engines to index those links. Any page which uses the delete template will be added to [[:Category:Nominated for Deletion]].
+
Only [[Help:User_rights|sysops]] can move or delete any pages. To request a page to be deleted, simply add {{Tlx|Delete|reason}}. Blanking the page is not sufficient or necessary, because the content is still available through the version history. It is only recommended to blank the page if it is a spam page which links to external sites, as this prevents search engines to index those links. Any page which uses the delete template will be added to [[:Category:Nominated for deletion]].
  
With {{Tlx|Move|new name|reason}} an page can be flagged that it should be moved to the new name. This will add the page to [[:Category:Move Requests]]. To aid the sysop with the moving of the page, it is recommended to check with [[Special:WhatLinksHere]] what pages link to the old name and then change this to the new name. The new page then should have a [[mw:Help:Redirects|redirect]] to the old page so those links won't get red. The advantage of using the move template, is that it saves the version history.
+
With {{Tlx|Move|new name|reason}} a page can be requested to be moved to the new name. This will add the page to [[:Category:Move requests]]. To aid the sysops with the moving of the page, it is recommended to check using [[Special:WhatLinksHere]] which pages link to the old name and then to change the links to the new name. The new page should at first have a [[mw:Help:Redirects|redirect]] to the old page so those links won't get red. It will later be overwritten by the moved page. The advantage of properly moving the page instead of copying the contents to the new page and deleting the old one is that it saves the version history.
  
 
== Talk page ==
 
== Talk page ==
 
If you have a question about something in an article you could use the talk page. To make it easier for other people to follow the discussion please create always a new topic (for example with the '''Add topic''' button on the top) if it is a new discussion. Also sign your posts with <nowiki>--~~~~</nowiki> so others could see who was saying that at what time. Note that the time is for the timezone [[w:Central_Time_Zone_(North_America)|CST/CDT]] (UTC-6:00/UTC-5:00) and may differ with the times display in the ''Version history''.
 
If you have a question about something in an article you could use the talk page. To make it easier for other people to follow the discussion please create always a new topic (for example with the '''Add topic''' button on the top) if it is a new discussion. Also sign your posts with <nowiki>--~~~~</nowiki> so others could see who was saying that at what time. Note that the time is for the timezone [[w:Central_Time_Zone_(North_America)|CST/CDT]] (UTC-6:00/UTC-5:00) and may differ with the times display in the ''Version history''.
  
== Articles which needs attention ==
+
When you see a comment on the discussion page which isn't signed use {{Tl|unsigned}} to sign it for them.
Those pages lists articles which needs to be created or edited:
+
 
* [[:Category:Update Requests]] lists outdated articles
+
== Galleries ==
 +
{{Box|This is more like a first draft, but some have huge galleries where a lot of them show primarily their craft and not necessarily something interesting otherwise.}}
 +
The galleries shouldn't be too long and should show primarily the described object of the page. So for example in an article about a body an image of a craft on top of the surface of that body shouldn't be added to the gallery. Instead such images should be only in the categories. An exception to this rule is when similarities is shown. For example an image of Kerbin and its moons can be used in Kerbin's gallery even when Kerbin is not the primary focus, but other objects shouldn't then not be in the focus. Another exception is when something else is visible, usually the craft to get there to get a screenshot, but it's moved out of the way to an edge or corner. If there are to many images (around 15 to 20), they should be properly categorized and then the category should be linked but not additional images added.
 +
 
 +
Images on a gallery shouldn't use any mods which are visible, as not every player is using the mods shown on an image. Mods which aren't adding parts or change textures are usually fine, as long as the GUI is not shown. Exceptions are of course pages which talk about the shown mod.
 +
 
 +
== Articles which need attention ==
 +
Those pages lists articles which need to be created or edited:
 +
* [[:Category:Update requests]] lists outdated articles
 
* [[:Category:Stubs]] lists incomplete articles
 
* [[:Category:Stubs]] lists incomplete articles
 
* [[Special:LonelyPages]] lists all pages which aren't referenced from other articles
 
* [[Special:LonelyPages]] lists all pages which aren't referenced from other articles
 
* [[Special:WantedPages]] lists all red links
 
* [[Special:WantedPages]] lists all red links
 +
The [[Project:Community portal|community portal]] can also be consulted for more information.
  
 
== See also ==
 
== See also ==
 
* [[Project:Translation|Translating articles]]
 
* [[Project:Translation|Translating articles]]
 
* [[Project:Templates|Templates]]
 
* [[Project:Templates|Templates]]
 +
* [[Project:Discussions|General discussions]]
 +
 +
== Additional resources ==
 +
* [[Project:Helpdesk|Helpdesk]], helpdesk for this wiki
 +
* [[w:Help:Contents|Help:Contents]], help of the English Wikipedia
 +
* [[metawikipedia:Help:Contents|Help:Contents]], help of the Wikimedia which is the organisation developing MediaWiki and maintaining the Wikipedia projects
 +
* [[mw:Project:Help|Project:Help]], help on MediaWiki which is the software used by this wiki

Revision as of 18:31, 17 March 2017

At the moment the content was only added by xZise and Ruedii, so it is likely far from complete and may not reflect the opinions of the other admins.

These guidelines help you in writing good articles and maintaining a consistent style with already existing ones.

General Editing

Some suggestions to help you be more constructive in your edits:

  • Be assertive: Don't be afraid to make changes. If you make a mistake in grammar or wording another editor can always correct it. If you put your added information in the wrong section of the page, it can always be moved. Just because your edit was corrected doesn't mean it wasn't appreciated, in fact quite the opposite, if it wasn't liked it would be simply deleted. If you are absolutely uncertain if something belongs, or how to phrase something you can always bring it up in the talk page and let someone else put it in.
  • Use common sense: Generally the phrasing should use minimal point of view, and should phrasing. Unlike Wikipedia, game perspective is fine, but other obvious rules still persist.Try to avoid expressing things in manners that may be considered offensive, and make sure all content is related to Kerbal Space Program in one manner or another.
  • Give other users the benefit of the doubt: It's generally a good idea to presume best intentions unless there is no way that good intentions could be presumed. This reduces arguing. It is simple to fix a mistake, but you won't do a good job of it if you are presuming the other person was making the mistake intentionally.

Linking to other articles

It is recommended to link without changing the link text (aka only with [[link target]]) with suffixes. Also when linking parts the name shouldn't be hidden. Either use the general page or the part name, so a visitor can always see, what is meant. So instead of “All command modules except the one have torque.” (source code: All [[Command module|command modules]] except the [[EAS-1 External Command Seat|one]] have torque.) it should be rewritten as “All command modules except the EAS-1 External Command Seat have torque.” (source code: All [[command module]]s except the [[EAS-1 External Command Seat]] have torque.). Because the first character is always uppercase a link to Command module doesn't differ to command module, but doesn't apply to any other character. For example cOmmand module won't link to Command module.

Naming articles

Kerbal Space Program specific content

Content from Kerbal Space Program, like the celestial bodies and parts should be named like the official naming ingame. The only exception at the moment is Kerbol which is officially called the Sun (see also discussion about naming Kerbol), and Kerbonaut which is never used in-game while "astronaut" is (see also Kerbonaut#Naming and Astronaut Complex). The official name of Parts could be retrieved by looking into the part.cfg of the part.

If an object in KSP get renamed, like the Inline Clamp-O-Tron (previously Hull-mounted Clamp-O-Tron), the old name redirect to the current name.

Other articles

General articles like aerobraking should use the common English capitalization: Only names begin with an uppercase character. The same applies to linking where most articles should start with a lowercase character (if they aren't a name).

Linking

Linking to parts

When linking to a part, it is recommended not to hide the link target. So when it links to a part directly the link text shouldn't be the type of part. For example instead of [[FL-T100 Fuel Tank|liquid fuel tank]] either [[liquid fuel tank]] or [[FL-T100 Fuel Tank]]. This helps readers to see what the link is about and, depending on the situation, if a statement is applying to the specific part linked or to all similar parts. For example the following sentence which hides the link target can be misleading:

The LV-T30 Liquid Fuel Engine uses fuel from liquid fuel tanks.

An inexperienced user may think there is only one liquid fuel tank or the LV-T30 only works with the FL-T100. Instead it should be written in one of the two ways:

The LV-T30 Liquid Fuel Engine uses fuel from tanks like the FL-T100 Fuel Tank.
The LV-T30 Liquid Fuel Engine uses fuel from liquid fuel tanks.

There is a third option, if there is no general article about the part type. This applies for example for the EAS-4 Strut Connector: There is no article strut but instead it redirects to the part page, which unfortunately hides the link target even further. But has the advantage that the links don't need to be changed, if in the future additional struts are available and there is a dedicated article about them.

Linking to Wikipedia

It is possible to link to an Wikipedia article with using the [[ and ]]. For example Kerbal Space Program in the English Wikipedia:

For further information see Interwiki link on the Wikimedia Meta-Wiki. Not all codes work directly, so to add a link to the German Wikipedia it first has to use a recognized prefix on this Wiki:

  • [[w:de:Kerbal Space Program|Kerbal Space Program]] generates Kerbal Space Program (German)
  • [[de:Kerbal Space Program|Kerbal Space Program]] does not work and generates a red link Kerbal Space Program

Usually a w: as a prefix followed by a prefix from the Meta-Wiki does work. All available interwiki links are shown at Special:Interwiki and lists also non Wikimedia related projects. The pipe trick helps linking need to write the target twice:

Linking to other project resources

To link to the official Kerbal Space Program forum or blog it is possible to use the prefixes thread and blog. It is not possible to link to a specific post (yet) with thread. The bug tracker IDs can be linked with tracker.

Moving and deleting pages

Only sysops can move or delete any pages. To request a page to be deleted, simply add {{Delete|reason}}. Blanking the page is not sufficient or necessary, because the content is still available through the version history. It is only recommended to blank the page if it is a spam page which links to external sites, as this prevents search engines to index those links. Any page which uses the delete template will be added to Category:Nominated for deletion.

With {{Move|new name|reason}} a page can be requested to be moved to the new name. This will add the page to Category:Move requests. To aid the sysops with the moving of the page, it is recommended to check using Special:WhatLinksHere which pages link to the old name and then to change the links to the new name. The new page should at first have a redirect to the old page so those links won't get red. It will later be overwritten by the moved page. The advantage of properly moving the page instead of copying the contents to the new page and deleting the old one is that it saves the version history.

Talk page

If you have a question about something in an article you could use the talk page. To make it easier for other people to follow the discussion please create always a new topic (for example with the Add topic button on the top) if it is a new discussion. Also sign your posts with --~~~~ so others could see who was saying that at what time. Note that the time is for the timezone CST/CDT (UTC-6:00/UTC-5:00) and may differ with the times display in the Version history.

When you see a comment on the discussion page which isn't signed use {{unsigned}} to sign it for them.

Galleries

This is more like a first draft, but some have huge galleries where a lot of them show primarily their craft and not necessarily something interesting otherwise.

The galleries shouldn't be too long and should show primarily the described object of the page. So for example in an article about a body an image of a craft on top of the surface of that body shouldn't be added to the gallery. Instead such images should be only in the categories. An exception to this rule is when similarities is shown. For example an image of Kerbin and its moons can be used in Kerbin's gallery even when Kerbin is not the primary focus, but other objects shouldn't then not be in the focus. Another exception is when something else is visible, usually the craft to get there to get a screenshot, but it's moved out of the way to an edge or corner. If there are to many images (around 15 to 20), they should be properly categorized and then the category should be linked but not additional images added.

Images on a gallery shouldn't use any mods which are visible, as not every player is using the mods shown on an image. Mods which aren't adding parts or change textures are usually fine, as long as the GUI is not shown. Exceptions are of course pages which talk about the shown mod.

Articles which need attention

Those pages lists articles which need to be created or edited:

The community portal can also be consulted for more information.

See also

Additional resources

  • Helpdesk, helpdesk for this wiki
  • Help:Contents, help of the English Wikipedia
  • Help:Contents, help of the Wikimedia which is the organisation developing MediaWiki and maintaining the Wikipedia projects
  • Project:Help, help on MediaWiki which is the software used by this wiki