diff --git a/api/CalendarEventGetCalendarType.lua b/api/CalendarEventGetCalendarType.lua
index c9f45cd..0ca88bc 100644
--- a/api/CalendarEventGetCalendarType.lua
+++ b/api/CalendarEventGetCalendarType.lua
@@ -1,9 +1,6 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@return PLAYER calendarType
----@return  GUILD_ANNOUNCEMENT
----@return  GUILD_EVENT
----@return  PLAYER
+---@return calendarType
 ---Returns the type of the selected calendar event
 function CalendarEventGetCalendarType() end
diff --git a/api/CalendarEventGetInvite.lua b/api/CalendarEventGetInvite.lua
index bc1d21d..bfdace6 100644
--- a/api/CalendarEventGetInvite.lua
+++ b/api/CalendarEventGetInvite.lua
@@ -6,20 +6,9 @@
 ---@return number level
 ---@return string className
 ---@return string classFileName
----@return 7 inviteStatus
----@return  1
----@return  2
----@return  3
----@return  4
----@return  5
----@return  6
----@return  7
----@return MODERATOR modStatus
----@return  CREATOR
----@return  MODERATOR
+---@return inviteStatus
+---@return modStatus
 ---@return boolean inviteIsMine
----@return 2 inviteType
----@return  1
----@return  2
+---@return inviteType
 ---Returns information about an entry in the selected event's invite/signup list
 function CalendarEventGetInvite(index) end
diff --git a/api/CalendarEventGetInviteSortCriterion.lua b/api/CalendarEventGetInviteSortCriterion.lua
index 8199a9b..fe6c786 100644
--- a/api/CalendarEventGetInviteSortCriterion.lua
+++ b/api/CalendarEventGetInviteSortCriterion.lua
@@ -1,10 +1,12 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@return status criterion
----@return CLASS_SORT_ORDER class
----@return  name
----@return  status
+---@alias criterion
+---| "CLASS" Sorted by character class (according to the global table CLASS_SORT_ORDER)
+---| "NAME" Sorted by character name
+---| "STATUS" Sorted by invite status
+
+---@return criterion
 ---@return boolean reverse
 ---Returns the current sort mode for the event invite/signup list
 function CalendarEventGetInviteSortCriterion() end
diff --git a/api/CalendarEventGetRepeatOptions.lua b/api/CalendarEventGetRepeatOptions.lua
index 69e129d..c7fc9c3 100644
--- a/api/CalendarEventGetRepeatOptions.lua
+++ b/api/CalendarEventGetRepeatOptions.lua
@@ -1,6 +1,6 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@return list ...
+---@return string[]
 ---Returns a list of localized event repetition option labels (currently unused)
 function CalendarEventGetRepeatOptions() end
diff --git a/api/CalendarEventGetStatusOptions.lua b/api/CalendarEventGetStatusOptions.lua
index d9faa72..2c052ba 100644
--- a/api/CalendarEventGetStatusOptions.lua
+++ b/api/CalendarEventGetStatusOptions.lua
@@ -1,6 +1,6 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@return list ...
+---@return string[]
 ---Returns a list of localized invite status labels
 function CalendarEventGetStatusOptions() end
diff --git a/api/CalendarEventGetTextures.lua b/api/CalendarEventGetTextures.lua
index 2119c95..20fbc8f 100644
--- a/api/CalendarEventGetTextures.lua
+++ b/api/CalendarEventGetTextures.lua
@@ -1,11 +1,13 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@param eventType 2 
----@param 1  
----@param 2  
----@return string name 
----@return string icon 
----@return number expansion 
+---@alias eventType
+---| 1 Raid dungeon
+---| 2 Five-player dungeon
+
+---@param eventType eventType
+---@param expansion number Expansion to which the instance belongs; localized names can be found in the constants EXPANSION_NAME0, EXPANSION_NAME1, etc. (number)
+---@return string name
+---@return string icon #Unique part of the path to the instance's icon texture; for the full path, prepend with "Interface\LFGFrame\LFGIcon-"
 ---Returns a list of instance names and icons for dungeon or raid events
-function CalendarEventGetTextures(eventType, 1, 2) end
\ No newline at end of file
+function CalendarEventGetTextures(eventType, expansion) end
diff --git a/api/CalendarEventGetTypes.lua b/api/CalendarEventGetTypes.lua
index 94553fe..8fdf442 100644
--- a/api/CalendarEventGetTypes.lua
+++ b/api/CalendarEventGetTypes.lua
@@ -1,6 +1,6 @@
 ---@diagnostic disable: missing-return, lowercase-global
 ---@meta
 
----@return list ...
+---@return string[]
 ---Returns a list of event display style labels
 function CalendarEventGetTypes() end