Improve heavy snow performance, add pedology support, add documentation

ca_effects/damage.lua

@@ -1,3 +1,11 @@
+--[[
+# Player Damage Effect
+Use this effect to damage a player during dangerous weather events.
+Expects a table as the parameter containing the following values:
+- ``value <number>``: The amount of damage to be applied per successful roll per cycle
+- ``chance <number>``: Defines a 1/x chance for the player to get damaged. Higher values result in less frequent damage.
+]]
+
 if not minetest.is_yes(minetest.settings:get_bool("enable_damage"))
 or not regional_weather.settings.damage then return end
 

ca_effects/lightning.lua

@@ -1,3 +1,10 @@
+--[[
+# Lightning Effect
+Use this effect to cause lightning strikes.
+Requires lightning mod in order to function.
+Uses default lightning configuration. Expects any non-nil parameter.
+]]
+
 if not minetest.get_modpath("lightning") then return end
 
 local EFFECT_NAME = "regional_weather:lightning"

ca_effects/speed_buff.lua

@@ -1,3 +1,9 @@
+--[[
+# Player Speed Effect
+Use this effect to modify a player's movement speed.
+Expects a numeric value that will be multiplied with the current speed physics.
+]]
+
 local EFFECT_NAME = "regional_weather:speed_buff"
 
 local function handle_effect(player_data)