Add more internal links, fix formatting

docs/modders/Bonus/Bonus_Types.md

@@ -78,9 +78,9 @@ Allows flying movement for affected heroes
 
 Eliminates terrain penalty on certain terrain types for affected heroes (Nomads ability).
 
-Note: to eliminate all terrain penalties see ROUGH_TERRAIN_DISCOUNT bonus
+Note: to eliminate all terrain penalties see [ROUGH_TERRAIN_DISCOUNT](#rough_terrain_discount) bonus
 
-- subtype: type of terrain, eg `terrain.sand`
+- subtype: type of terrain, eg `sand`
 
 ### TERRAIN_NATIVE
 
@@ -182,7 +182,7 @@ Allows affected heroes to position army before start of battle (Tactics)
 
 ### BEFORE_BATTLE_REPOSITION_BLOCK
 
-Reduces distance in which enemy hero can reposition. Counters BEFORE_BATTLE_REPOSITION bonus
+Reduces distance in which enemy hero can reposition. Counters [BEFORE_BATTLE_REPOSITION](#before_battle_reposition) bonus
 
 - val: distance within which hero can reposition his troops
 
@@ -200,7 +200,7 @@ Increases experience gain from combat by affected units. No effect if stack expe
 
 ### UNDEAD_RAISE_PERCENTAGE
 
-Defines percentage of enemy troops that will be raised after battle into own army (Necromancy). Raised unit is determined by IMPROVED_NECROMANCY bonus
+Defines percentage of enemy troops that will be raised after battle into own army (Necromancy). Raised unit is determined by [IMPROVED_NECROMANCY](#improved_necromancy) bonus
 
 - val: percentage of raised troops
 

docs/modders/Entities_Format/Spell_Format.md

@@ -270,20 +270,24 @@ Most of battle effects are scaled based on spell effect value. This value is sam
 ```text
 caster spell power * base spell power + spell mastery power(caster spell school)
 ```
+
 Where:
-- `caster spell school` is assumed spell school level for the spell. For unit this is value of SPELLCASTER bonus. For hero this is value of MAGIC_SCHOOL_SKILL or SPELL bonus, whichever is greater
+
+- `caster spell school` is assumed spell school level for the spell. For unit this is value of [SPELLCASTER](../bonus/Bonus_Types.md#spellcaster) bonus. For hero this is value of [MAGIC_SCHOOL_SKILL](../bonus/Bonus_Types.md#magic_school_skill) or [SPELL](../bonus/Bonus_Types.md#spell) bonus, whichever is greater
 - `spell mastery power` is `power` parameter defined in config of corresponding mastery level of the spell
 - `base spell power` is `power` parameter, as defined in config of spell itself
-- `caster spell power` is spellpower of the hero, or CREATURE_SPELL_POWER bonus for units
+- `caster spell power` is spellpower of the hero, or [CREATURE_SPELL_POWER](../bonus/Bonus_Types.md#creature_spell_power) bonus for units
 
-If unit has SPECIFIC_SPELL_POWER bonus for corresponding spell, game will use value of the bonus instead
+If unit has [SPECIFIC_SPELL_POWER](../bonus/Bonus_Types.md#specific_spell_power) bonus for corresponding spell, game will use value of the bonus instead
 
 Power of `damage`, `heal`, `summon`, and `demonSummon` effects cast by hero can also be affected by following bonuses:
-- SPECIAL_SPELL_LEV bonus for the spell, scaled down by target level (Solmyr / Deemer)
+
+- [SPECIAL_SPELL_LEV](../bonus/Bonus_Types.md#special_spell_lev) bonus for the spell, scaled down by target level (Solmyr / Deemer)
 
 Following bonuses will only affect `damage`, `heal` and `demonSummon` effects
-- SPELL_DAMAGE for specific spell school (Sorcery)
-- SPECIFIC_SPELL_DAMAGE for the spell (Luna / Ciele)
+
+- [SPELL_DAMAGE](../bonus/Bonus_Types.md#spell_damage) for specific spell school (Sorcery)
+- [SPECIFIC_SPELL_DAMAGE](../bonus/Bonus_Types.md#specific_spell_damage) for the spell (Luna / Ciele)
 
 ## Smart target modifier
 
@@ -373,14 +377,14 @@ Configurable version of Clone spell. Casting the spell will create clone of targ
 ### Damage
 
 Deals specified damage to all affected targets based on spell effect value:
+
 - if `killByPercentage` is set, spell will deal damage equal to unit total health * [spell effect power](#spell-power) / 100
 - if `killByCount` is set, spell will deal damage equal to single creature health * [spell effect power](#spell-power)
 - if neither flag is set, spell will deal damage equal to [spell effect power](#spell-power)
 
 If spell has chain effect, damage dealt to chained target will be multiplied by specified `chainFactor`
 
-Target with SPELL_DAMAGE_REDUCTION bonus with value greater than 100% for any of spell school of the spell are immune to this effect
-
+Target with [SPELL_DAMAGE_REDUCTION](../bonus/Bonus_Types.md#spell_damage_reduction) bonus with value greater than 100% for any of spell school of the spell are immune to this effect
 
 ```json
 "firstSpellEffect":{
@@ -393,6 +397,7 @@ Target with SPELL_DAMAGE_REDUCTION bonus with value greater than 100% for any of
 ### Dispel
 
 Dispells all bonuses provided by any other spells from this unit. Following spells can not be dispelled
+
 - Disrupting ray
 - Acid Breath
 - any effects from adventure spells
@@ -401,7 +406,6 @@ Dispells all bonuses provided by any other spells from this unit. Following spel
 Only bonuses from spells with specified positiveness(es) will be dispelled. See configuration example.
 
 ```json
-
 "firstSpellEffect":{
 	"type": "core:dispel",
 	
@@ -558,7 +562,6 @@ If `summonByHealth` option is set, then number of summoned units will be equal t
 
 if `summonSameUnit` flag is set, and same creature was already summoned before, spell will instead heal unit in "overheal" mode, using same [spell effect power](#spell-power).
 
-
 ```json
 "firstSpellEffect":{
 	"type": "core:summon",
@@ -578,6 +581,7 @@ if `summonSameUnit` flag is set, and same creature was already summoned before,
 Implements Pit Lord's ability with the same name. Raises targeted dead unit as unit specified in spell parameters on casters side. New unit will be placed on the same position as corpse, and corpse will be removed from the battlefield
 
 Raised amount of units is limited by (rounded down):
+
 - total HP of summoned unit can not be larger than [spell effect power](#spell-power) of caster
 - total HP of summoned unit can not be larger than total HP of dead unit
 - total stack size of summoned unit can not be greater than stack size of dead unit
@@ -619,13 +623,14 @@ Timed effect gives affected units specified bonuses for duration of the spell.
 
 Duration of effect is:
 
-- Hero: Spellpower + value of SPELL_DURATION + SPELL_DURATION for specific spell
-- Units: value of CREATURE_ENCHANT_POWER, or 3 if no such bonus
+- Hero: Spellpower + value of [SPELL_DURATION](../bonus/Bonus_Types.md#spell_duration) + [SPELL_DURATION](../bonus/Bonus_Types.md#spell_duration) for specific spell
+- Units: value of [CREATURE_ENCHANT_POWER](../bonus/Bonus_Types.md#creature_enchant_power), or 3 if no such bonus
 
 Value of all bonuses can be affected by following bonuses:
-- SPECIAL_PECULIAR_ENCHANT: value modified by 1-3 according to level of target unit
-- SPECIAL_ADD_VALUE_ENCHANT: value from addInfo is added to val of bonus
-- SPECIAL_FIXED_VALUE_ENCHANT: value from addInfo replaces val of bonus
+
+- [SPECIAL_PECULIAR_ENCHANT](../bonus/Bonus_Types.md#special_peculiar_enchant): value modified by 1-3 according to level of target unit
+- [SPECIAL_ADD_VALUE_ENCHANT](../bonus/Bonus_Types.md#special_add_value_enchant): value from addInfo is added to val of bonus
+- [SPECIAL_FIXED_VALUE_ENCHANT](../bonus/Bonus_Types.md#special_fixed_value_enchant): value from addInfo replaces val of bonus
 
 ```json
 "firstSpellEffect" : {

docs/modders/Guides/Bonus_System.md

@@ -137,7 +137,7 @@ This propagator extends the ability to all units in the hero's army, including t
 
 ### Bonus Updaters
 
-Unlike propagators and limiters, updaters do not modify the entities affected by the bonus; instead, they modify the bonus itself. This is primarily used for H3 hero specialties, which are often scaled according to the level of the hero or the level of the affected unit. However, it is possible to use updaters in other areas if desired. Example: 
+Unlike propagators and limiters, updaters do not modify the entities affected by the bonus; instead, they modify the bonus itself. This is primarily used for H3 hero specialties, which are often scaled according to the level of the hero or the level of the affected unit. However, it is possible to use updaters in other areas if desired. Example:
 
 ```json
 "specialty" : {
@@ -176,6 +176,7 @@ For example, to implement the morale-reducing ability of Ghost Dragons, you can
 ```
 
 As can be seen from the example, such bonuses must perform the following operations to work:
+
 - The `BATTLE_WIDE` propagator extends the effect of the bonus to the entire battlefield.
 - a `BONUS_OWNER_UPDATER` propagation updater – to indicate which side of the battlefield the bonus originates from
 - an `OPPOSITE_SIDE` limiter to restrict the bonus to units (or heroes) belonging to the other side of the battle.
@@ -190,9 +191,10 @@ In this diagram, all entities connected to an entity above it are considered to
 
 ![Bonus System Nodes Diagram](../../images/Bonus_System_Nodes.svg)
 
-### Combining updaters, propagators and limiters 
+### Combining updaters, propagators and limiters
 
 When the game evaluates bonuses, the following order of operations is performed:
+
 - If the bonus has a propagator, the game will attempt to look upwards through the bonus tree to find the entity to which the bonus should be propagated.
 - If such an entity is found and the bonus has a propagation updater, the updater is executed using the context of the bonus source.
 - The bonus is then moved to the entity to which it was propagated.
@@ -200,6 +202,7 @@ When the game evaluates bonuses, the following order of operations is performed:
 - Once all bonuses have been collected, the game executes the limiter on each bonus and drops the bonus on a negative result.
 
 As a result, there are some considerations you should bear in mind.
+
 - The bonus updater is executed on every entity between the bonus source (or the bonus propagation target if a propagator is used). For example, a bonus propagated to a hero from a creature can use updaters that require either the hero or the creature.
 - The bonus propagation updater, however, can only be used with updaters that require a creature as context in the case of a creature ability.
-- A bonus limiter can only be used on the final entity through which the game accesses the bonus system for this particular bonus. For example, the SPECIAL_UPGRADE bonus is checked from the hero's perspective and can only be used with limiters that are valid for heroes.
+- A bonus limiter can only be used on the final entity through which the game accesses the bonus system for this particular bonus. For example, the SIGHT_RADIUS bonus is checked from the hero's perspective and can only be used with limiters that are valid for heroes.