Contributing: Difference between revisions

From Melvor Idle
m (→‎Versioning: Added example text.)
(→‎Versioning: updated template types, grammar)
(31 intermediate revisions by 10 users not shown)
Line 1: Line 1:
{{V0.10.1}}
If you want to help with the wiki, join our [https://discord.gg/KNakXTh Discord] and message Malcs (aka MrFrux)#6454 or Falterfire#7778 for an account.


If you want to help with the wiki, join our [https://discord.gg/KNakXTh Discord] and message mrDLSable#8493 for an account.
== Bot ==
 
{{Main|Reference=Bot}}
== Notice ==
We're working on a [[Bot|bot]] which will fill out the wiki automatically from the game's code.  Its next version will generate improved item sources sections for item pages.
We're working on a [[bot|bot]] which will fill out the wiki automatically from the game's code.  It's next version will automatically fill out the [[Template:Item|Item Template]]. So the item and enemy pages don't have to be created by hand.


== What to do ==
== What to do ==
{{Main|Reference=Contributing/To-Do List}}
If you want to help but don't know what you can do, here are a couple of things you can do:
If you want to help but don't know what you can do, here are a couple of things you can do:
{{:Contributing/To-Do List}}
== What not to do ==
As a result of the bot generating much of the content on the wiki from the game's source code, please do not manually edit the content generated by it. This will disrupt the automatic version flagging when new versions of the game are released, and can potentially decrease the overall accuracy of information on the wiki and style consistency.
If you wish to add information on pages with generated content, please edit the text above the placement of the template. For example, {{ItemIcon|Crown of Rhaelyx|ext=png}}.
Generated content currently includes:
* The [[Template:Item|Item Template]], [[Template:ArmourStats|Armour Stats Template]], and [[Template:WeaponStats|Weapon Stats Template]] on [[:Category:Items|Item]] pages
* The [[:Category:Item Sources|Item Source Templates]] generated for each item page
* The [[Template:Monster|Monster Template]] on [[:Category:Monsters|Monster]] pages
* The [[Template:Dungeon|Dungeon Template]], [[Template:SlayerArea|Slayer Area Template]], and [[Template:CombatArea|Combat Area Template]] on [[:Category:Dungeons|Dungeon]], [[:Category:Slayer Areas|Slayer Area]], and [[:Category:Combat Areas|Combat Area]] pages respectively
* The [[Template:Prayer|Prayer Template]] on [[:Category:Prayers|Prayer]] pages
* The [[Template:Spell|Spell Template]], [[Template:Aurora|Aurora Template]], [[Template:Curse|Curse Template]], [[Template:AncientMagick|Ancient Magick Template]], and [[Template:AltMagic|Alt. Magic Template]] on [[:Category:Spells|Spell]] pages
* The [[Template:Pet|Pet Template]] on [[:Category:Pets|Pet]] pages
* The [[Template:Upgrade|Shop Upgrade Template]] on [[:Category:Upgrades|Upgrade]] pages, with the exception of [[Shop#Miscellaneous|Misc. Upgrades]] which are maintained manually.
* All [[:Category:Tables|Table Templates]]


* Check [[Special:WantedPages| Wanted Pages]] to see what pages are missing.
If you do find an issue with the accuracy of information in any of these templates, it is possible that the internal game data is flawed, or there has been a recent hotfix (hidden update without a version number change) to the game code and the bot needs to run an update to the pages.
* Check [[:Category:Pages with broken file links]] to see what images are missing.
* Expand [[Special:ShortPages| Short Pages]].
* Check pages with old [[:Category:Versions]] and update them.


== Templates ==
== Templates ==
Line 18: Line 32:


=== Versioning ===
=== Versioning ===
We have created a system of templates to mark which pages are up to date. At the top of every page there should be a template for which version the page is written. For example, if a page is written for version 0.09.2 you would add <nowiki>{{v0.09.2}}</nowiki> to the top of the page. Each page should have a version attached to it. Every version can be found in the [[:Category:Versions|Versions Category]]. One of the main tasks is to make sure that pages are up to date.
We have created a system of templates to mark which pages are up to date. At the top of every page there should be a template indicating for which version the page is written. This will look like either {{T|V}} or {{T|V|0.18.0}}.
* If a page is entirely populated by either the [[bot]] or Lua-powered templates, then simply add {{T|V}} to the top of the page.
* If a page contains a decent amount of user-written text that has the potential to change with each version, then the version number should be specified. For example, if a page is written for version 0.18.0 you would add {{T|V|0.18.0}} to the top of the page.
Each page should have a version attached to it. Every version can be found in the [[:Category:Versions|Versions Category]]. One of the main tasks is to make sure that pages are up to date.


You can view the versioning system in action on the top right corner of this page.
You can view the versioning system in action on the top right corner of this page.


=== Main article ===
If you have a bit of text in a page but have more text explaining that concept on another page, it might be a good idea to use the [[Template:Main|Main Template]]. This template adds a formatted link to the main article to the page. It can be seen in action on the [[Beginners Guide]].
== Tables with Sticky Headers ==
Some of the tables on the wiki have headers which are "sticky", that is they will remain at the top of a table as the user scrolls down. See [[Equipment]] for an example of this. In order to implement this on your tables first add the class "stickyHeader" to the start of the table. E.g:
<code>{| class="wikitable sortable"</code>
would become:
<code>{| class="wikitable sortable stickyHeader"</code>
Before you start your first row of headers you then add <code>|- class="headerRow-0"</code> before it.
If you have a second row of headers you must add <code>|- class="headerRow-1"</code> before it.
As an example:
{| class="wikitable sortable stickyHeader"
|- class="headerRow-0"
! First Column 1
! Second Column 1
! Third Column 1
|- class="headerRow-1"
! First Column 2
! Second Column 2
! Third Column 2
|-
| 1
| 2
| 3
|}
Can be generated with the following wikitext
<pre>{| class="wikitable sortable stickyHeader"
|- class="headerRow-0"
! First Column 1
! Second Column 1
! Third Column 1
|- class="headerRow-1"
! First Column 2
! Second Column 2
! Third Column 2
|-
| 1
| 2
| 3
|}
</pre>


{{Menu}}
{{Menu}}

Revision as of 01:20, 22 March 2021

If you want to help with the wiki, join our Discord and message Malcs (aka MrFrux)#6454 or Falterfire#7778 for an account.

Bot

- Main article: Bot

We're working on a bot which will fill out the wiki automatically from the game's code. Its next version will generate improved item sources sections for item pages.

What to do

- Main article: Contributing/To-Do List

If you want to help but don't know what you can do, here are a couple of things you can do:

  • Check Category:Out of Date pages, update them if necessary, and then update the template call on the page to the newest version.
  • Check Category:Pages with broken file links and fix missing images if needed.
  • Update pages such as the Money Making Guide or the FAQ to weed out answers that are obsolete and update ones that are out of date.
  • Look through existing Guides and refine the formatting or add additional information.

What not to do

As a result of the bot generating much of the content on the wiki from the game's source code, please do not manually edit the content generated by it. This will disrupt the automatic version flagging when new versions of the game are released, and can potentially decrease the overall accuracy of information on the wiki and style consistency.

If you wish to add information on pages with generated content, please edit the text above the placement of the template. For example, Crown of Rhaelyx.

Generated content currently includes:

If you do find an issue with the accuracy of information in any of these templates, it is possible that the internal game data is flawed, or there has been a recent hotfix (hidden update without a version number change) to the game code and the bot needs to run an update to the pages.

Templates

We use a number of templates on the wiki for various purposes. Such as the {{Menu}} template for the menu at the bottom of the page.

Versioning

We have created a system of templates to mark which pages are up to date. At the top of every page there should be a template indicating for which version the page is written. This will look like either {{V}} or {{V|0.18.0}}.

  • If a page is entirely populated by either the bot or Lua-powered templates, then simply add {{V}} to the top of the page.
  • If a page contains a decent amount of user-written text that has the potential to change with each version, then the version number should be specified. For example, if a page is written for version 0.18.0 you would add {{V|0.18.0}} to the top of the page.

Each page should have a version attached to it. Every version can be found in the Versions Category. One of the main tasks is to make sure that pages are up to date.

You can view the versioning system in action on the top right corner of this page.

Main article

If you have a bit of text in a page but have more text explaining that concept on another page, it might be a good idea to use the Main Template. This template adds a formatted link to the main article to the page. It can be seen in action on the Beginners Guide.

Tables with Sticky Headers

Some of the tables on the wiki have headers which are "sticky", that is they will remain at the top of a table as the user scrolls down. See Equipment for an example of this. In order to implement this on your tables first add the class "stickyHeader" to the start of the table. E.g:

{| class="wikitable sortable"

would become:

{| class="wikitable sortable stickyHeader"

Before you start your first row of headers you then add |- class="headerRow-0" before it.

If you have a second row of headers you must add |- class="headerRow-1" before it.

As an example:

Can be generated with the following wikitext

{| class="wikitable sortable stickyHeader"
|- class="headerRow-0"
! First Column 1
! Second Column 1
! Third Column 1
|- class="headerRow-1"
! First Column 2
! Second Column 2
! Third Column 2
|-
| 1
| 2
| 3
|}