Template:Hero Changelogs/doc

Formatting notes for Hero Changelogs.

Hero Reworked

 * Bold Reworked Hero. Include hero minimap icons.
 * Insert other attributes and mechanics reworked in the middle.
 * Hero new basic abilities and new ultimate ability in a sentence.
 * Format new abilities according to New reworked abilities.

. (other attributes and mechanics changes in the middle) .
 * Reworked . (To see the previous Hero, see here).
 * Hero now has, , as their basic ability and  as their ultimate ability.

Hero Attributes

 * Hero attributes in changelogs will follow the following sequence:
 * Attributes ( / / )
 * Base attributes and attribute gain should be separated.
 * Followed by other mechanics according to Template:MechanicsNav. (discuss with other admins)

Miscellaneous

 * No formatting for the following:
 * Replaced hero model.
 * Added visual effects.
 * Renamed hero.

Abilities

 * Only use one hero minimap icon per version.
 * Arrange hero abilities according to sequence in client.
 * Summoned units that belongs to hero goes one level below their hero abilities respectively.
 * Only exception is there are only value changes to summoned unit and not the ability itself.

Moved

 * Moved ability should be placed before any ability value changes.
 * Only use moved when the ability slots are changed.


 * Moved to the first/second/third ability.
 * Moved to the fourth ability slot. This is now 's ultimate ability.

Values Increased/Reduced

 * Use only one level for one change in the same ability.
 * Add another level if there are more than one change to the same ability.
 * Add another level if ability have summons.
 * Add % to all % based values.

Added/Removed Abilities

 * Bold Added including the new Ability ID.
 * Add another level to describe the ability.
 * Use the same level to add more description or notes if needed.
 * Bold the Removed word following with the Ability ID.
 * No descriptions needed.

Added Sub-ability

 * Bold Added including the new Sub-ability ID.
 * Use another level to describe the ability if needed.
 * Use same level definition lists to add more ability values if necessary.


 * Added the sub-ability.
 * Description.

Added Innate Ability

 * Use definition lists and do not italicize new abilities or sub-abilities.
 * Use the same level for the ability descriptions and italicize them.
 * Add another level and list some of the important ability values.
 * Use the same level for more ability values.
 * Use the same level to add notes.


 * Added the innate ability for .
 * Ability description.
 * Cast range:
 * Duration:
 * Notes::
 * Notes::

Aghanim's Scepter Upgrade

 * Start the line with " upgrade:"
 * Group added upgrades according to ability, then increased/reduced value.
 * Use another level if there are more than one components to the upgrade.

Upgrade Values Increased/Reduced

 * Use simple past tense for increased/reduced upgrade values.
 * In this example below, another level is used because no longer increases duration.


 * upgrade:
 * values increased/reduced from value on each level to multiple values.

Upgrades Added/Removed

 * Use another level if current version adds/removes a component from the upgrade.
 * Use the Undocumented feature if an ability is replaced and the Scepter upgrade is removed along with it, or if the upgrade is moved to the new replaced ability.
 * Use simple present tense for newly added upgrades.


 * upgrade:
 * Component A gets interrupted when caster is rooted.
 * Increased {{A|Ability_Name}|Hero}} leap duration from x to y.


 * Bold the whole sentence when it is added or removed from hero. Include hero minimap icon for this change.


 * Removed upgrade for {{H|Hero}.
 * No longer.


 * Added upgrade for :
 * 

Reworked Upgrades

 * (definition of reworked upgrade here)
 * Bold only the Reworked word and link to Aghanim's Scepter page.
 * Old: Add another level for the Old upgrade.
 * New: Use the same level for the New upgrade.


 * Reworked upgrade:
 * Old:
 * New:

Granted Abilities

 * Start the line depending on whether it's reworked or added.
 * Use definition lists and do not italicize abilities or sub-abilities granted by Aghanim's Scepter.
 * Use the same level for the ability descriptions and italicize them.
 * Add another level and list some of the important ability values.
 * Use the same level for more ability values.
 * Use the same level to add notes.


 * upgrade:
 * Grants {H|Hero}} the ability and the {{A|Sub-Ability_Name|Hero} sub-ability.
 * Ability_Name
 * Italicize ability descriptions here.
 * Cast range:
 * Mana cost:
 * Cooldown:


 * Sub-Ability_Name
 * Italicize ability descriptions here.
 * Duration:
 * Mana cost:
 * Notes: Here are some notes.

Talents

 * Talent wordings should follow accordingly to how it is displayed in client.
 * Use links moderately in talents.
 * Abilities:, etc.
 * Attributies:, ,
 * Mechanics: regen, cooldown reduction etc.
 * For example, although Radius should be the correct term for the increased value, however it is displayed as AoE because it is shown as AoE in client. Same goes for talents displaying regen instead of regeneration.

New Talent Tree

 * Use the following format for added/new talent trees.
 * Do not add fullstops to heavily reworked talents.


 * Added Talents:
 * Level 10: left_talent or right_talent
 * Level 15: left_talent or right_talent
 * Level 20: left_talent or right_talent
 * Level 25: left_talent or right_talent

Values Increased/Reduced

 * Talents:
 * Level xx left talent: increased to.
 * Level xx right talent: reduced to.

Reworked/Replaced

 * Use ➜ (U+279C) arrow to indicate minor talent changes from old to new.


 * Talents:
 * Level xx left/right talent changed: ➜.


 * Start a new bullet list for heavily Reworked Talents:.
 * Include Old: and New: talents for reference.
 * Do not add fullstops for reworked talents. Consider heavily reworked talents as new talent trees.


 * Reworked talents:
 * Old:
 * Level 10: left_talent or right_talent
 * Level 15: left_talent or right_talent
 * Level 20: left_talent or right_talent
 * Level 25: left_talent or right_talent
 * New:
 * Level 10: left_talent or right_talent
 * Level 15: left_talent or right_talent
 * Level 20: left_talent or right_talent
 * Level 25: left_talent or right_talent