Refactor API functions to improve parameter aliasing and enhance documentation clarity

api/GetSpellCritChance.lua

@@ -1,14 +1,16 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param school 7 
----@param 1  
----@param 2  
----@param 3  
----@param 4  
----@param 5  
----@param 6  
----@param 7  
----@return number minCrit 
+---@alias spellSchool
+---| 1 - Physical
+---| 2 - Holy
+---| 3 - Fire
+---| 4 - Nature
+---| 5 - Frost
+---| 6 - Shadow
+---| 7 - Arcane
+
+---@param school spellSchool
+---@return number minCrit
 ---Returns the player's spell critical strike chance for a spell school
-function GetSpellCritChance(school, 1, 2, 3, 4, 5, 6, 7) end
+function GetSpellCritChance(school) end