Module:Changelog/doc
This is the documentation page for Module:Changelog
Overview
Generates lines of changes for all data pages. See for the dates of all changelogs, and Changelogs for list of all the data pages that contain a Changelog.
How to edit changelogs
Each changelogs should be exactly as written on the forum post, so edits are rarely justified, below are the exceptions to look out for
- Typos by the poster should have
{{sic}}
added so that readers know the typoe was intentionally written verbatim - An entity's name is old, i.e. Yamato's Shadow Explosion was renamed to Shadow Transformation. See #Missing tags for detailed examples
- Similarly named but unrelated entities (tags) are both mistakenly assigned, i.e. Barrage and Heavy Barrage. See #Similar tags are assigned for detailed examples
- Entity is referenced but isn't affected by the change. See #Tag referenced but unaffected for a detailed example
What are tags?
Each line in a changelog is parsed by User:DeadBot to have certain tags assigned to it. For example, if the forum post looks like Abrams: Shoulder Bash blah blah
It will be assigned tags, Shoulder Bash
since its named explicitly, and therefore Ability
, Abrams
, and Hero
. This will make this line added to all changelogs on pages Abrams/Update history, Shoulder Bash/Update history, Ability/Update history, and Hero/Update history.
Similarly, for the line Warp Stone: Distance traveled blah blah
, the tags assigned would be Warp Stone
since its named explicitly, along with the tags Item
and Weapon Item
.
Missing tags
Given the line Yamato: Shadow Explosion bonus Spirit per victim increased from 10 to 15
, User:DeadBot will be able to assign the Yamato
tag, but will not know which ability it is referring to, as Yamato's ability was renamed to Shadow Transformation. This would originally appear as
"Description": "* {{PageRef|Yamato}}: Shadow Explosion bonus Spirit per victim increased from 10 to 15", "Tags": [ "Yamato", "Hero" ]
To correct is, simply add the related tags for Shadow Transformation. To determine the related tags, see To see all related tags, see Module:Changelog/doc#Tag tree. Add the call to Template:PageRef in the description. The alt_name
parameter will need to be passed to nickname the ability as Shadow Explosion, so that it stays written as is, but still links and is added to the relevant pages. The corrected changelog would then be
"Description": "* {{PageRef|Yamato}}: {{PageRef|Shadow Transformation|alt_name=Shadow Explosion}} bonus Spirit per victim increased from 10 to 15", "Tags": [ "Yamato", "Hero", "Ability", "Shadow Transformation" ]
Similar tags are assigned
Given the line * McGinnis: Heavy Barrage spirit scaling increased from 0.3 to 0.35
, User:DeadBot will see both McGinnis' Heavy Barrage ability and Pocket's Barrage ability and assign both as tags. This would originally appear as
"Description": "* {{PageRef|McGinnis}}: {{PageRef|Heavy Barrage}} spirit scaling increased from 0.3 to 0.35", "Tags": [ "McGinnis", "Hero", "Heavy Barrage", "Ability", "Barrage", "Pocket" ]
To correct it, first determine if its referring to McGinnis' Heavy Barrage or Pocket's Barrage. In this case, it is quite obvious that its referring to McGinnis' Heavy Barrage. Then, simply remove all tags related to Pocket's Barrage. This includes both "Barrage"
and "Pocket"
. To determine all related tags, see Module:Changelog/doc#Tag tree.
The corrected list of tags would then be
"Tags": [ "McGinnis", "Hero", "Heavy Barrage", "Ability", ]
Similarly, for the following example
"Description": "* {{PageRef|Torment Pulse}}: Interval improved from 2s to 1.5s", "Tags": [ "Torment Pulse", "Item", "Spirit Item", "Pulse", "Ability", "Rutger", "Hero" ]
It is actually referring to Torment Pulse the Item, so the tags "Pulse"
, "Ability"
, and "Rutger"
, "Hero"
would all need to be removed.
Another example, given the line:
"Description": "* {{PageRef|Cosmic Veil|alt_name=Veil}} {{PageRef|Walker}}: Cooldown increased from 20s to 25s", "Tags": [ "Veil Walker", "Item", "Vitality Item", "Objective", "NPC", "Walker" "Cosmic Veil" ]
Here, the changelog is clearly referring to the item Veil Walker, not Cosmic Veils and Walkers. The fixed line would be:
"Description": "* {{PageRef|Veil Walker}}: Cooldown increased from 20s to 25s", "Tags": [ "Veil Walker", "Item", "Vitality Item", "Objective", "NPC", ]
Tag referenced but unaffected
Given the line Surge of Power: When the passive procs, you no longer get slowed when shooting (similar to Fleetfoot).
, User:DeadBot will assign the tag Fleetfoot and all its related tags, even if Fleetfloot wasn't actually changed or modified at all. This would originally appear as
"Description": "* {{PageRef|Surge of Power}}: When the passive procs, you no longer get slowed when shooting (similar to {{PageRef|Fleetfoot}})", "Tags": [ "Fleetfoot", "Item", "Weapon Item", "Surge of Power", "Spirit Item" ]
To correct it, remove Fleetfoot and all its related tags (Weapon Item tag in this case), but leave the call to PageRef so that it can still refer users to the Fleetfoot page. After correction it should be
"Description": "* {{PageRef|Surge of Power}}: When the passive procs, you no longer get slowed when shooting (similar to {{PageRef|Fleetfoot}})", "Tags": [ "Item", "Surge of Power", "Spirit Item" ]
Tag tree
The tag tree is how to determine what tags are related. Given a tag, the tags that are in the same chain and have a shorter indentation will/should also be added to the list of tags.
For example, any change to Frost Bomb will also be referenced on the pages Ability, Kelvin, and Hero.
- Hero
- <hero_name> i.e. Abrams
- Ability
- <ability_name> i.e. Frost Bomb
- Ability
- <hero_name> i.e. Abrams
- Item
- Weapon Item
- <weapon_item_name> i.e. Basic Magazine
- Vitality Item
- <vitality_item_name> i.e. Extra Health
- Spirit Item
- <spirit_item_name> i.e. Boundless Spirit
- Weapon Item
- Map
- Other
More Tag tree examples:
- If
Map
tag is assigned, no other tags should be assigned - If
Weapon Item
is assigned,Basic Magazine
shouldn't be assigned unless it is also referenced in the line, butItem
should be assigned - If
Basic Magazine
is assigned,Weapon Item
, andItem
should be assigned
The full tree can be found at Changelogs
Invokes
Invokes are callable by wikitext, i.e. {{#invoke|Changelog|invokable_name|param1|paramN}}
write_changelogs
The main invokable that will be used. Given a specific tag, it outputs all relevant changelogs from all dates in a Template:Update history table.
Parameters
- tag - Tag to search relevant changelogs for. Should be localized, i.e. Abrams for hero_atlas in english.
- num_dates - (OPTIONAL) Number of dates to add, recommend 3 for articles. If unprovided, defaults to all.
Examples
For use on Pocket/Update history:
{{#invoke:Changelog|write_changelogs|Pocket}}
Outputs Script error: The function "write_changelogs" does not exist.
For use on Pocket#Update history:
{{#invoke:Changelog|write_changelogs|Pocket|3}}
Outputs
Script error: The function "write_changelogs" does not exist.
write_data_pages_list
Writes list of all changelog data pages using the list of patches at Data:ChangelogConfigs.json. Used on .
Parameters
None
Examples
{{#invoke:Changelog|write_data_pages_list}}
Outputs
Data:Changelog 2024-05-03.json
Data:Changelog 2024-05-10.json
Data:Changelog 2024-05-13.json
Data:Changelog 2024-05-16.json
Data:Changelog 2024-05-19.json
Data:Changelog 2024-05-23.json
Data:Changelog 2024-05-24.json
Data:Changelog 2024-05-30.json
Data:Changelog 2024-06-01.json
Data:Changelog 2024-06-06.json
Data:Changelog 2024-06-07.json
Data:Changelog 2024-06-13.json
Data:Changelog 2024-06-14.json
Data:Changelog 2024-06-16.json
Data:Changelog 2024-06-20.json
Data:Changelog 2024-06-23.json
Data:Changelog 2024-06-27.json
Data:Changelog 2024-07-04.json
Data:Changelog 2024-07-11.json
Data:Changelog 2024-07-18.json
Data:Changelog 2024-07-23.json
Data:Changelog 2024-08-01.json
Data:Changelog 2024-08-06.json
Data:Changelog 2024-08-15.json
Data:Changelog 2024-08-16.json
Data:Changelog 2024-08-18.json
Data:Changelog 2024-08-22.json
Data:Changelog 2024-08-23.json
Data:Changelog 2024-08-29.json
Data:Changelog 2024-09-01.json
Data:Changelog 2024-09-12.json
Data:Changelog 2024-09-14.json
Data:Changelog 2024-09-17.json
Data:Changelog 2024-09-19.json
Data:Changelog 2024-09-26.json
Data:Changelog 2024-09-27.json
Data:Changelog 2024-09-29.json
Data:Changelog 2024-10-02.json
Data:Changelog 2024-10-07.json
Data:Changelog 2024-10-10.json
Data:Changelog 2024-10-11.json
Data:Changelog 2024-10-15.json
Data:Changelog 2024-10-18.json
Data:Changelog 2024-10-18-1.json
Data:Changelog 2024-10-24.json
Data:Changelog 2024-10-24_HeroLab.json
Data:Changelog 2024-10-27.json
Data:Changelog 2024-10-29.json
Data:Changelog 2024-10-29_HeroLab.json
Data:Changelog 2024-11-01.json
Data:Changelog 2024-11-01_HeroLab.json
Data:Changelog 2024-11-07.json
Data:Changelog 2024-11-07_HeroLab.json
Data:Changelog 2024-11-08_HeroLab.json
Data:Changelog 2024-11-10.json
Data:Changelog 2024-11-13.json
Data:Changelog 2024-11-21.json
Data:Changelog 2024-11-21_HeroLab.json
Data:Changelog 2024-11-24_HeroLab.json
Data:Changelog 2024-11-26_HeroLab.json
Data:Changelog 2024-11-29.json
Data:Changelog 2024-12-06.json
Data:Changelog 2024-12-06_HeroLab.json
Data:Changelog 2024-12-17.json
write_changelog_by_date_id
Write's a specific date's changelog, as opposed to a specific tag's changelog.
Parameters
- date_id_to_write - Date-id to write, format yyyy-mm-dd, view all at
Examples
{{#invoke:Changelog|write_changelog_by_date_id|05-03-2024}}
date_id 05-03-2024 not found
get_last_updated
Retrieve the last date that a tag was updated on
Parameters
- tag - Tag to search
Examples
{{#invoke:Changelog|get_last_updated|Basic Magazine}}
Outputs
Todo
Frontend
- Create a more generic icon template Template:PageRef for svg's with color inverting depending on light/dark mode