Advent of Ascension Wiki:Updating the wiki to 3.0 guidelines

The following page documents the guidelines for updating the wiki in regards to the event of, and following, the release of the 3.0 version of Advent of Ascension.

Purpose of guidelines
Put simply, the 3.0 update to Advent of Ascension is a massive update. With the mod undergoing an entire rewrite, and following a new direction; the release of 3.0 and the updates following it are going to change a lot of content in the mod. On top of this, the mod is also updating across versions of Minecraft (1.7.10->1.12.2). This alone is a significant enough change to pose concerns about how we handle content updates in regards to their documentation on the wiki.

Normally, when an update is released for the mod, the wiki is updated to reflect any changes the new version of the mod has over the old one. While not all players may be able to update their mod due to compatibility issues, the majority will follow the mod's progress and update when a new version is available. For the sake of simplicity and ease of use, we keep only the most up-to-date information on each of the wiki pages relating to the content the page is about. However with the update to Minecraft 1.12, it poses a problem as a fairly large portion of the player base will remain on 1.7.10 due to substantial mod availability issues and other concerns. In an effort to prevent the players of the 1.7.10 version of the mod having to play without an effective wiki, as well as for historical reasons, it has been decided that a slightly different process will be followed in updating content on the wiki between 1.7.10 and 1.12.2+.

These guidelines are to help establish how the wiki should be updated when 3.0 is released, and following its release, in order to best ensure that all content for both 1.7.10 and 1.12.2+ is accounted for and placed in their proper places, and everything is consistent.

Page types
The guidelines for updating will differ between types of pages on the wiki. The following page types are the different groups in which this page will detail the guidelines for updating:
 * Content page - this is a page that documents a specific piece of content in the mod (a block, item, AoA Notice Board, etc).
 * Content hub page - this is a page that outlines general information about a group of content in the mod, with links to the individual specific articles where applicable.<!-Better wording?-->. Example content hub pages include skills, mobs, and dimensions.
 * Guide page - this is a non-formal page written as a guide for completing or accessing some content within the mod.<!-Informal, but still need to consider the impact of these guidelines-->

Images and other media are given their own guidelines later in this page.

Applicability
What kind of update to a wiki page should be considered when following the below page update guidelines? An update to a wiki page should be considered as falling under these guidelines when they meet all of the following criteria:


 * The change to the page relates to a non-aesthetic change to the content it is referring to. For example, a changing an image file is an aesthetic change, and is not covered by these guidelines, AND:
 * The change would normally cause information on the page from the 1.7.10 versions of the mod to be relegated to the 'history' section of the page, and these guidelines have not been previously applied to the page, OR:
 * The change adds content to the page that is not present in the 1.7.10 versions of the mod, and these guidelines have not been previously applied to the page.
 * The update involves an existing piece of content on the wiki. New content should be created normally

Content page
If a wiki page is classified as a content page, as defined in the above section, the following guidelines apply:


 * 1) If an update to the article falls within the above applicability rules, then before making the change, the entirety of the article should be duplicated to a 1.7.10 subpage. From this point onwards, the non-subpage version of the article is considered 'the original'.
 * 2) The template for a version-subpage should be inserted at the top of the original page.
 * 3) Any changes that would normally be added to the history section of the page should be done on the original page only.
 * 4) The changes to the article can be made on the original page, with the 1.7.10 subpage left unchanged

Content hub page
If a wiki page is classified as a content hub page, as defined in an above section, then the following guidelines apply:


 * 1) Any change to the article should be made as normally done. Content hub pages should not have subpages created for them.
 * 2) Any content that is specific to one of the items in the hub page should be made to the relevant article, per the standard process.

Guide page
If a mod/content guide article, as defined in the page types section, then the following guidelines apply:


 * 1) Any change to the page should be made with regards to the version of the mod the content was originally written for.
 * 2) If a change is specific to 1.12.2+ versions of the mod, then the page should be duplicated to a 1.7.10 subpage.
 * 3) The changes to the page can be made on the original page, with the 1.7.10 subpage left unchanged

Images and other media
If an image, sound, video, or other type of media changes in or following the 3.0 update, then the following guidelines apply:


 * 1) Before the new version of the media is uploaded, the old, outdated version of the media should be moved to a new title:  1.7.10.png/gif.
 * 2) The new, updated media can be uploaded under the original name.
 * 3) Care should be taken as far as reasonably possible to ensure that legacy articles that specifically use the old media be modified to use the changed file as necessary

Content name change
If some content in the mod has had its name changed, then the following guidelines apply:

If the content's name has changed but its associated texture has not, then:
 * 1) The content should be moved to its new name. A redirect under the old name should be made, redirecting to the new name.
 * 2) An edit to the history section of the article if applicable should be considered

If the content's name and its associated texture has changed, then:
 * 1) The content should be created under the new name, with the previous content kept under the old name.