Help:Wiki Conventions: Difference between revisions

Help page
(Removing references to the image functionality until thumbnailing can be fixed)
m (Remove whitespace)
 
(10 intermediate revisions by 2 users not shown)
Line 1: Line 1:
This is a generalized outline of how things are done here on the RPCS3 wiki. These conventions are meant to guidelines, instructions, and help for those new to the wiki. These guidelines will continue to evolve as the wiki grows, and this page will be updated periodically to reflect the changes that have occurred.  
This is a generalized outline of how things are done here on the RPCS3 wiki. These conventions are meant to guidelines, instructions, and help for those new to the wiki. These guidelines will continue to evolve as the wiki grows, and this page will be updated periodically to reflect the changes that have occurred.


Contributions are always welcome on the wiki. Our mission is to be the best resource for accurate and up-to-date RPCS3 information. Everything on the wiki is built around that goal. As such, pages, problems and everything else on the wiki is aimed at the very latest development release, updating and changing based on what goes on with development. Furthermore, accuracy matters, and anything that can be reproduced is favored, and subjective information is avoided.
Contributions are always welcome on the wiki. Our mission is to be the best resource for accurate and up-to-date RPCS3 information. Everything on the wiki is built around that goal. As such, pages, problems and everything else on the wiki is aimed at the very latest development release, updating and changing based on what goes on with development. Furthermore, accuracy matters, and anything that can be reproduced is favored, and subjective information is avoided.


Also, see our [[To Do List|to-do list]] for list of functionalities to be added and pages that require updation in the wiki.
To get started, please visit the [[Help:Contents|Help section]] that contains a list of articles aimed to address most problems that users may face and provide valuable information regarding RPCS3 and this wiki.


== Formatting ==
== Creating or Updating Game Articles ==
All pages and templates of this wiki are written using wiki markup. Consult the [https://www.mediawiki.org/wiki/Special:MyLanguage/Help:Contents Users' Guide] for information on using the wiki software and text markup. Do familiarise yourself with the various markups present in [https://www.mediawiki.org/wiki/Help:Formatting formatting] and [https://www.mediawiki.org/wiki/Help:Links links] help pages. The best way to get up to speed with the formatting is to read other pages in the wiki. When in doubt, feel free to use the talk page found in the discussion tab above the page title. Please adhere to the specific markup requirements for the talk pages mentioned [[#Talk pages|below]].
Instructions on how to create new pages for games that are not present in this wiki and updating information in existing pages can be found [[Help:Creating New Game Pages|here]].
 
== Creating Game Articles ==
Before creating a new game page, check the [[:Category:Games| games category]] to confirm that the page for such game does not already exist. Only one game page is created for all versions of a game. This means that all region IDs, demos, DLCs and special editions of a game will be grouped together in the same game page (see [[Find a game that does this]]).
 
'''Currently we are only creating game pages for games "playable" as per the compatibility list.'''
 
To create a new game page, enter the game name as the page title. If a game has multiple titles in various languages, please use the english one in the page title. Where more than one english title exists, use the one that is more common (generally the US version). Once the page has been created, enter <code><nowiki>{{subst:newgame}}</nowiki></code> in the page and save to populate the default templates and sections for game pages.
 
=== Infobox ===
This is the box on the right-hand side of the page which summarises the basic information of the game. The infobox is also linked to its own set of categories which allows you to find games with similar information in a convenient manner. Game infoboxes use the [[Template:vginfobox|vginfobox]] template, which contains parameters requiring various details. For guidance on how to fill the template, kindly read the documentation provided in its template page along with [[Template:vgregion|vgregion]] and [[Template:gameid|gameid]] templates.
 
=== Description ===
A description should be brief but include some basic information about what the game is and what its gameplay is like. Usually we put the name of the game fairly early in the description, and put it in '''''<nowiki>'''''bold italics'''''</nowiki>'''''. Links to relevant articles, such as prequels or sequels, are always good. Most of the time we just pull descriptions from wikipedia and tweak them a bit, removing things like references to other systems and release dates or other information already covered in the infobox.
 
=== Configuration ===
This section uses the [[Template:config|configuration]] template to capture non-default settings for maximum emulation accuracy or explicitly broken enhancement options on game pages. The complete list of default settings can be found [[Default Settings|here]]. An ideal configuration setup lists all the settings needed for flawless emulation regardless of performance. Each configuration entry can also include a "notes" entry to highlight any necessary information or explain the issue(s) addressed.
 
Recommendatory settings, like telling users with weaker CPUs to try ''Lower SPU thread priority'', shouldn't be included. Such guidance applies to all games and has already been covered in the default settings pages. Also, if an unusual setting improves performance and does nothing else, it still shouldn't be included here, but a note may be placed under the [[#Special Notes|Special Notes]] section.
 
Other improvements not related to compatibility should also be left off the configuration list. For example, if someone turns on the ''Anisotropic filter'', they know what they are getting into. The exception to that is if it toggling such settings causes issues, like a crash or unusual sprites.
 
Please do not use this area for recommended controller configurations. What buttons are assigned to which binding varies based on the game, the controller being used, and personal tastes. It is up to users to figure that out.
 
=== Known Issues ===
This section should contain a list of issues that affect the latest master. Do not post issues here without discussing the same on forums and discord. Also, read the [https://github.com/RPCS3/rpcs3/issues issue tracker] on Github to check if such issues have been reported. Most problems users face can be resolved by using the appropriate settings for that title. If you are convinced the issue is valid, only document issues on the wiki after discussing the same with developers or moderators on forums or discord.
 
Give the issue a title in '''bold'''. Where available, use the [[Template:issue|issues]] template to link the corresponding issue on Github. <!-- If the issue has a screenshot showcasing the problem, the screenshot should be included using the [[Template:Image|image]] template and must have a caption (mandatory) with a brief description of the image. However, captions cannot be too long as they wont be automatically truncated.
-->If an issue is fixed in the master repo, it should be moved to the bottom and the title of the issue should be crossed out with the slash <code><nowiki><s></nowiki></code> tags (<code><nowiki><s>like this</s></nowiki></code>) with a note describing how it was fixed and by which pull request if that info is known. Use the [[Template:issue|pull request]] template to link the corresponding PR on Github. On a periodic basis, all existing fixed issues are purged, so it is vital to fill out when and why an issue was fixed so it can be cleared later. Each issue is listed on its own without grouping, to make it easier to deal with. Issues are generally ordered with the most severe ones first, such as crashing or hanging bugs, then going to down to the least severe and fixed issues at the bottom.
 
=== Special Notes ===
This area is used to describe behaviors or information that aren't necessarily emulation issues (e.g. PSN version of Demon's Souls show the Blu-ray version's game ID on the game list, information on patches, etc.) but details which users may find useful. Information present in this section generally shouldn't affect the compatibility status of a given title. This section need not be shown if there's no suitable entries for that game, otherwise it's listed right after the Known Issues section.


<!-- == Images ==
<!-- == Images ==
The sidebar has an '''''Upload file''''' link, use that to upload images. So we can actually find the images, they should be appropriately named, and they should have categories for whatever they are mentioned in the summary. Below are the most commonly used image categories.
The sidebar has an '''''Upload file''''' link, use that to upload images. So we can actually find the images, they should be appropriately named, and they should have categories for whatever they are mentioned in the summary. Below are the most commonly used image categories.


* Cover arts: <code><nowiki>[[Category:Game covers]]</nowiki></code>  
* Cover arts: <code><nowiki>[[Category:Game covers]]</nowiki></code>
* Screenshots showcasing emulation problems: <code><nowiki>[[Category:Bug images]]</nowiki></code>
* Screenshots showcasing emulation problems: <code><nowiki>[[Category:Bug images]]</nowiki></code>
-->
-->
== Talk pages ==
== Using Talk Pages ==
Every wiki page has an associated talk page, which can be used for discussion and communicating with other users. Talk pages can be accessed by clicking the "discussion" tab at the top of the page. Having discussions on a free-form wiki page may seem strange at first but the talk pages are a great way to a pointed discussion about a particular page. Please go through the [https://en.wikipedia.org/wiki/Wikipedia:Talk_page_guidelines talk page guidelines] for a detailed explanation on the conventions. A few broad conventions have been mentioned below.
Instructions on properly use talk pages in this wiki can be found [[Help:Using Talk Pages|here]].


=== Basic conventions ===
== Formatting ==
While using a talk page, users must follow certain basic conventions such as:
All pages and templates of this wiki are written using wiki markup. Consult the [https://www.mediawiki.org/wiki/Special:MyLanguage/Help:Contents Users' Guide] for information on using the wiki software and text markup. Do familiarise yourself with the various markups present in [https://www.mediawiki.org/wiki/Help:Formatting formatting] and [https://www.mediawiki.org/wiki/Help:Links links] help pages. The best way to get up to speed with the formatting is to read other pages in the wiki. When in doubt, feel free to use the talk page found in the discussion tab above the page title. Please adhere to the specific markup requirements for the talk pages mentioned [[#Talk pages|below]].
* Every new discussion must have begin with a <code><nowiki>== level 2 heading ==</nowiki></code> at the bottom of the page (or use the "Add topic" tab).
* Indent replies with colons (<code>:</code>) at the beginning of the line.
* Always sign your name after your comments. Use the four tildes "<code><nowiki>~~~~</nowiki></code>" wiki syntax (or the signature button in the toolbar above the editing textbox). For more information see the user guide for [https://www.mediawiki.org/wiki/Help:Signatures signatures].
 
Here is an example discussion, following the talk page conventions:
{| class="wikitable"
!style="width:50%" |Wiki text
!style="width:50%" |Rendered talk page
|-
|
<code><nowiki>== Code == </nowiki></code><br>
<code><nowiki>How's the code? --~~~~</nowiki></code><br>
<code><nowiki>: It's great!! --~~~~</nowiki></code><br>
<code><nowiki>:: I made it myself! --~~~~</nowiki></code><br>
<code><nowiki>I think the code-discussion should be moved to Talk:Github.. --~~~~</nowiki></code><br>
|
<span style= font:"Linux Libertine, Georgia, Times, serif"; font-size:120%;>'''Code'''</span>
----
How's the code? --DH (talk) 18:37, 3 November 2012 (UTC)
: It's great!! --Hykem (talk) 18:38, 3 November 2012 (UTC)
:: I made it myself! --DH (talk) 18:39, 3 November 2012 (UTC)
I think the code-discussion should be moved to Talk:Github.. --AlexAltea (talk) 10:32, 8 September 2013 (UTC)
|}
 
=== Editing others' comments ===
It is not necessary to bring talk pages to publishing standards, so there is no need to correct typing/spelling errors, grammar, etc. It may irritate the users whose comments you are correcting. The basic rule, with some specific exceptions, is that you should '''NOT''' edit or delete the comments of other editors without their permission. '''Never''' edit or move someone's comment to change its meaning, ''even on your own talk page''.
 
Generally, you should not break up another editor's text by interleaving your own replies to individual points; this confuses who said what and obscures the original editor's intent. Cautiously editing or removing another editor's comments is sometimes allowed, but normally you should stop if there is any objection. If you make anything more than minor changes it is good practice to leave a short explanatory note such as <nowiki>"[piracy links removed by ~~~~]"</nowiki>.
 
Refer [https://en.wikipedia.org/wiki/Wikipedia:Talk_page_guidelines#Editing_others'_comments Editing others' comments] section of the talk page guidelines for an exhaustive list of scenarios where it ''may'' be appropriate to edit another user's post.


== Disagreements ==
== Disagreements ==
If two editors are changing things back and forth in a disagreement, they need to STOP and head to the talk pages. The wiki is entirely open, anyone can edit it, so disagreements need to be settled with communication and compromises.
If two editors are changing things back and forth in a disagreement, they need to STOP and head to the talk pages. The wiki is entirely open, anyone can edit it, so disagreements need to be settled with communication and compromises.
== Attribution and re-use ==
This page has been adapted from [https://wiki.dolphin-emu.org/index.php?title=Project:Wiki_Conventions Dolphin Emulator Wiki] released under the [https://creativecommons.org/licenses/by-sa/3.0/ Creative Commons Attribution-ShareAlike 3.0 License].

Latest revision as of 00:58, 30 January 2023

This is a generalized outline of how things are done here on the RPCS3 wiki. These conventions are meant to guidelines, instructions, and help for those new to the wiki. These guidelines will continue to evolve as the wiki grows, and this page will be updated periodically to reflect the changes that have occurred.

Contributions are always welcome on the wiki. Our mission is to be the best resource for accurate and up-to-date RPCS3 information. Everything on the wiki is built around that goal. As such, pages, problems and everything else on the wiki is aimed at the very latest development release, updating and changing based on what goes on with development. Furthermore, accuracy matters, and anything that can be reproduced is favored, and subjective information is avoided.

To get started, please visit the Help section that contains a list of articles aimed to address most problems that users may face and provide valuable information regarding RPCS3 and this wiki.

Creating or Updating Game Articles

Instructions on how to create new pages for games that are not present in this wiki and updating information in existing pages can be found here.

Using Talk Pages

Instructions on properly use talk pages in this wiki can be found here.

Formatting

All pages and templates of this wiki are written using wiki markup. Consult the Users' Guide for information on using the wiki software and text markup. Do familiarise yourself with the various markups present in formatting and links help pages. The best way to get up to speed with the formatting is to read other pages in the wiki. When in doubt, feel free to use the talk page found in the discussion tab above the page title. Please adhere to the specific markup requirements for the talk pages mentioned below.

Disagreements

If two editors are changing things back and forth in a disagreement, they need to STOP and head to the talk pages. The wiki is entirely open, anyone can edit it, so disagreements need to be settled with communication and compromises.