diff --git a/core/src/commonMain/kotlin/ClientResources.kt b/core/src/commonMain/kotlin/ClientResources.kt
index 5c2a1c2c8c1c..5964dd1fb68c 100644
--- a/core/src/commonMain/kotlin/ClientResources.kt
+++ b/core/src/commonMain/kotlin/ClientResources.kt
@@ -5,6 +5,16 @@ import dev.kord.core.supplier.EntitySupplyStrategy
 import dev.kord.gateway.builder.Shards
 import io.ktor.client.*
 
+/**
+ * The resources for the Kord Instance.
+ *
+ * @param token The Bots token
+ * @param applicationId The ID of the application
+ * @param shards The [Shards] for the application
+ * @param maxConcurrency The maximum concurrency for the bot. Can be obtained by calling the `Route.GatewayBotGet` endpoint.
+ * @param httpClient The [HttpClient] the client is connected through
+ * @param defaultStrategy The default [EntitySupplyStrategy] for the client.
+ */
 public class ClientResources(
     public val token: String,
     public val applicationId: Snowflake,
diff --git a/core/src/commonMain/kotlin/Kord.kt b/core/src/commonMain/kotlin/Kord.kt
index f116b1b2571e..bc4634bd3135 100644
--- a/core/src/commonMain/kotlin/Kord.kt
+++ b/core/src/commonMain/kotlin/Kord.kt
@@ -62,13 +62,16 @@ public class Kord(
     private val interceptor: GatewayEventInterceptor,
 ) : CoroutineScope {
 
+    /**
+     * Returns a [Flow] of Nitro [StickerPack]s
+     */
     public val nitroStickerPacks: Flow<StickerPack>
         get() = defaultSupplier.getNitroStickerPacks()
 
 
     /**
      * The default supplier, obtained through Kord's [resources] and configured through [KordBuilder.defaultStrategy].
-     * By default a strategy from [EntitySupplyStrategy.rest].
+     * By default, a strategy from [EntitySupplyStrategy.rest].
      *
      * All [strategizable][Strategizable] [entities][KordEntity] created through this instance will use this supplier by default.
      */
@@ -99,9 +102,15 @@ public class Kord(
 
     override val coroutineContext: CoroutineContext = SupervisorJob() + dispatcher
 
+    /**
+     * Returns a [Flow] of [Region]s know to the bot.
+     */
     public val regions: Flow<Region>
         get() = defaultSupplier.regions
 
+    /**
+     * Returns a [Flow] of [Guild]s know to the bot.
+     */
     public val guilds: Flow<Guild>
         get() = defaultSupplier.guilds
 
@@ -148,6 +157,12 @@ public class Kord(
 
     public fun <T : EntitySupplier> with(strategy: EntitySupplyStrategy<T>): T = strategy.supply(this)
 
+    /**
+     * Requests to get the information of the current application using the [EntitySupplyStrategy.rest] supplier.
+     *
+     * Entities will be fetched from Discord directly, ignoring any cached values.
+     * @throws RestRequestException when the request failed.
+     */
     public suspend fun getApplicationInfo(): Application = with(EntitySupplyStrategy.rest).getApplicationInfo()
 
     /**
@@ -366,6 +381,11 @@ public class Kord(
     ): Invite? = with(EntitySupplyStrategy.rest).getInviteOrNull(code, withCounts, withExpiration, scheduledEventId)
 
 
+    /**
+     * Gets a [Sticker] from its [id].
+     *
+     * @return [EntityNotFoundException.stickerNotFound] if the sticker is not found
+     */
     public suspend fun getSticker(id: Snowflake): Sticker = defaultSupplier.getSticker(id)
 
 
@@ -426,11 +446,23 @@ public class Kord(
         }
     }
 
-
+    /**
+     * Gets the [GlobalApplicationCommand]s for this bot.
+     *
+     * @param withLocalizations Whether to get the commands with localisations or not. Defaults to `null`
+     * @return a [Flow] of [GlobalApplicationCommand]s for this bot.
+     */
     public fun getGlobalApplicationCommands(withLocalizations: Boolean? = null): Flow<GlobalApplicationCommand> {
         return defaultSupplier.getGlobalApplicationCommands(resources.applicationId, withLocalizations)
     }
 
+    /**
+     * Gets the [GuildApplicationCommand]s for a given [guildId].
+     *
+     * @param guildId The ID of the guild to get the commands for
+     * @param withLocalizations Whether to get the commands with localizations or not. Defaults to `null`
+     * @return a [Flow] of [GuildApplicationCommand]s for the given [guildId].
+     */
     public fun getGuildApplicationCommands(
         guildId: Snowflake,
         withLocalizations: Boolean? = null,
@@ -438,11 +470,24 @@ public class Kord(
         return defaultSupplier.getGuildApplicationCommands(resources.applicationId, guildId, withLocalizations)
     }
 
+    /**
+     * Gets a [GuildApplicationCommand] based on the [guildId] and [commandId].
+     *
+     * @param guildId The ID of the guild to get the command for
+     * @param commandId The ID of the command to get
+     * @return The [GuildApplicationCommand] or [EntityNotFoundException.applicationCommandNotFound] if it was not found.
+     */
     public suspend fun getGuildApplicationCommand(guildId: Snowflake, commandId: Snowflake): GuildApplicationCommand {
         return defaultSupplier.getGuildApplicationCommand(resources.applicationId, guildId, commandId)
     }
 
-
+    /**
+     * Gets a [GuildApplicationCommand] based on the [guildId] and [commandId].
+     *
+     * @param guildId The ID of the guild to get the command from
+     * @param commandId The ID of the command to get
+     * @return The [GuildApplicationCommand] or `null` if it was not found.
+     */
     public suspend fun getGuildApplicationCommandOrNull(
         guildId: Snowflake,
         commandId: Snowflake
@@ -450,7 +495,13 @@ public class Kord(
         return defaultSupplier.getGuildApplicationCommandOrNull(resources.applicationId, guildId, commandId)
     }
 
-
+    /**
+     * Gets a Guild application command of type [T], based on the [guildId] and [commandId]
+     *
+     * @param guildId The ID the guild to get the command from
+     * @param commandId The ID of the command to get
+     * @return The command of type [T] or [EntityNotFoundException.applicationCommandNotFound] if it was not found.
+     */
     public suspend inline fun <reified T : GuildApplicationCommand> getGuildApplicationCommandOf(
         guildId: Snowflake,
         commandId: Snowflake
@@ -458,7 +509,13 @@ public class Kord(
         return defaultSupplier.getGuildApplicationCommandOf(resources.applicationId, guildId, commandId)
     }
 
-
+    /**
+     * Gets a Guild application command of type [T], based on the [guildId] and [commandId]
+     *
+     * @param guildId The ID the guild to get the command from
+     * @param commandId The ID of the command to get
+     * @return The command of type [T] or `null` if it was not found.
+     */
     public suspend inline fun <reified T : GuildApplicationCommand> getGuildApplicationCommandOfOrNull(
         guildId: Snowflake,
         commandId: Snowflake
@@ -466,27 +523,55 @@ public class Kord(
         return defaultSupplier.getGuildApplicationCommandOfOrNull(resources.applicationId, guildId, commandId)
     }
 
-
+    /**
+     * Gets a [GlobalApplicationCommand] based off the [commandId].
+     *
+     * @param commandId The ID of the command to get.
+     * @return The [GlobalApplicationCommand] or [EntityNotFoundException.applicationCommandNotFound] if it was not found.
+     */
     public suspend fun getGlobalApplicationCommand(commandId: Snowflake): GlobalApplicationCommand {
         return defaultSupplier.getGlobalApplicationCommand(resources.applicationId, commandId)
     }
 
-
+    /**
+     * Gets a [GlobalApplicationCommand] based off the [commandId].
+     *
+     * @param commandId The ID of the command to get.
+     * @return The [GlobalApplicationCommand] or `null` if it was not found.
+     */
     public suspend fun getGlobalApplicationCommandOrNull(commandId: Snowflake): GlobalApplicationCommand? {
         return defaultSupplier.getGlobalApplicationCommandOrNull(resources.applicationId, commandId)
     }
 
-
+    /**
+     * Gets a Global application command of type [T] based off the [commandId].
+     *
+     * @param commandId The ID of the command to get.
+     * @return The application command of type [T] or [EntityNotFoundException.applicationCommandNotFound] if it was not found.
+     */
     public suspend fun <T> getGlobalApplicationCommandOf(commandId: Snowflake): T {
         return defaultSupplier.getGlobalApplicationCommandOf(resources.applicationId, commandId)
     }
 
-
+    /**
+     * Gets a Global application command of type [T] based off the [commandId].
+     *
+     * @param commandId The ID of the command to get.
+     * @return The application command of type [T] or `null` if it was not found.
+     */
     public suspend fun <T> getGlobalApplicationCommandOfOrNull(commandId: Snowflake): T? {
         return defaultSupplier.getGlobalApplicationCommandOfOrNull(resources.applicationId, commandId)
     }
 
 
+    /**
+     * Creates a [GlobalChatInputCommand] for this bot.
+     *
+     * @param name The command name
+     * @param description The command description
+     * @param builder A [GlobalChatInputCreateBuilder] to modify the command.
+     * @return The [GlobalChatInputCommand] for the bot.
+     */
     public suspend inline fun createGlobalChatInputCommand(
         name: String,
         description: String,
@@ -503,6 +588,13 @@ public class Kord(
         return GlobalChatInputCommand(data, rest.interaction)
     }
 
+    /**
+     * Creates a [GlobalMessageCommand] for this bot.
+     *
+     * @param name The command name
+     * @param builder A [GlobalMessageCommandCreateBuilder] to modify the command.
+     * @return The [GlobalMessageCommand] for the bot.
+     */
     public suspend inline fun createGlobalMessageCommand(
         name: String,
         builder: GlobalMessageCommandCreateBuilder.() -> Unit = {},
@@ -514,6 +606,13 @@ public class Kord(
         return GlobalMessageCommand(data, rest.interaction)
     }
 
+    /**
+     * Creates a [GlobalUserCommand] for this bot.
+     *
+     * @param name The command name
+     * @param builder A [GlobalUserCommandCreateBuilder] to modify the command.
+     * @return The [GlobalUserCommand] for the bot.
+     */
     public suspend inline fun createGlobalUserCommand(
         name: String,
         builder: GlobalUserCommandCreateBuilder.() -> Unit = {},
@@ -525,7 +624,12 @@ public class Kord(
         return GlobalUserCommand(data, rest.interaction)
     }
 
-
+    /**
+     * Creates multiple [GlobalApplicationCommand]s.
+     *
+     * @param builder A [GlobalMultiApplicationCommandBuilder] to create the commands in.
+     * @return A [Flow] of [GlobalApplicationCommand]s for the bot.
+     */
     public suspend inline fun createGlobalApplicationCommands(
         builder: GlobalMultiApplicationCommandBuilder.() -> Unit,
     ): Flow<GlobalApplicationCommand> {
@@ -540,6 +644,16 @@ public class Kord(
         }
     }
 
+    /**
+     * Creates a [GuildChatInputCommand] for a given [guildId]
+     *
+     * @param guildId The ID of the guild to create the command
+     * @param name The name of the command
+     * @param description The description of the command
+     * @param builder A [ChatInputCreateBuilder] to modify the command
+     *
+     * @return a [GuildChatInputCommand] object for the command
+     */
     public suspend inline fun createGuildChatInputCommand(
         guildId: Snowflake,
         name: String,
@@ -560,6 +674,15 @@ public class Kord(
     }
 
 
+    /**
+     * Creates a [GuildMessageCommand] for a given [guildId]
+     *
+     * @param guildId The ID of the guild to create the command
+     * @param name The name of the command
+     * @param builder A [MessageCommandCreateBuilder] to modify the command
+     *
+     * @return a [GuildMessageCommand] object for the command
+     */
     public suspend inline fun createGuildMessageCommand(
         guildId: Snowflake,
         name: String,
@@ -576,6 +699,15 @@ public class Kord(
         return GuildMessageCommand(data, rest.interaction)
     }
 
+    /**
+     * Creates a [GuildUserCommand] for a given [guildId]
+     *
+     * @param guildId The ID of the guild to create the command
+     * @param name The name of the command
+     * @param builder A [UserCommandCreateBuilder] to modify the command
+     *
+     * @return a [GuildUserCommand] object for the command
+     */
     public suspend inline fun createGuildUserCommand(
         guildId: Snowflake,
         name: String,
@@ -593,7 +725,12 @@ public class Kord(
         return GuildUserCommand(data, rest.interaction)
     }
 
-
+    /**
+     * Creates multiple [GuildApplicationCommand]s.
+     *
+     * @param builder A [GuildMultiApplicationCommandBuilder] to create the commands in.
+     * @return A [Flow] of [GuildApplicationCommand]s for the bot.
+     */
     public suspend inline fun createGuildApplicationCommands(
         guildId: Snowflake,
         builder: GuildMultiApplicationCommandBuilder.() -> Unit,
diff --git a/core/src/commonMain/kotlin/Unsafe.kt b/core/src/commonMain/kotlin/Unsafe.kt
index 269d0676fb5c..615be4e3921a 100644
--- a/core/src/commonMain/kotlin/Unsafe.kt
+++ b/core/src/commonMain/kotlin/Unsafe.kt
@@ -26,94 +26,287 @@ import dev.kord.rest.service.InteractionService
 @KordUnsafe
 @KordExperimental
 public class Unsafe(private val kord: Kord) {
-
+    /**
+     * Returns an [AutoModerationRuleBehavior] for a given [guildId].
+     *
+     * @param guildId The ID to create the [AutoModerationRuleBehavior] for
+     * @param ruleId The ID of the [AutoModerationRuleBehavior]
+     * @return The created [AutoModerationRuleBehaviorImpl]
+     */
     public fun autoModerationRule(guildId: Snowflake, ruleId: Snowflake): AutoModerationRuleBehavior =
         AutoModerationRuleBehaviorImpl(guildId, ruleId, kord)
 
+    /**
+     * Returns an [KeywordAutoModerationRuleBehavior] for a given [guildId].
+     *
+     * @param guildId The ID to create the [KeywordAutoModerationRuleBehavior] for
+     * @param ruleId The ID of the [KeywordAutoModerationRuleBehavior]
+     * @return The created [KeywordAutoModerationRuleBehaviorImpl]
+     */
     public fun keywordAutoModerationRule(guildId: Snowflake, ruleId: Snowflake): KeywordAutoModerationRuleBehavior =
         KeywordAutoModerationRuleBehaviorImpl(guildId, ruleId, kord)
 
+    /**
+     * Returns an [SpamAutoModerationRuleBehavior] for a given [guildId].
+     *
+     * @param guildId The ID to create the [SpamAutoModerationRuleBehavior] for
+     * @param ruleId The ID of the [SpamAutoModerationRuleBehavior]
+     * @return The created [SpamAutoModerationRuleBehaviorImpl]
+     */
     public fun spamAutoModerationRule(guildId: Snowflake, ruleId: Snowflake): SpamAutoModerationRuleBehavior =
         SpamAutoModerationRuleBehaviorImpl(guildId, ruleId, kord)
 
+    /**
+     * Returns an [KeywordPresetAutoModerationRuleBehavior] for a given [guildId].
+     *
+     * @param guildId The ID to create the [KeywordPresetAutoModerationRuleBehavior] for
+     * @param ruleId The ID of the [KeywordPresetAutoModerationRuleBehavior]
+     * @return The created [KeywordPresetAutoModerationRuleBehaviorImpl]
+     */
     public fun keywordPresetAutoModerationRule(
         guildId: Snowflake,
         ruleId: Snowflake,
     ): KeywordPresetAutoModerationRuleBehavior = KeywordPresetAutoModerationRuleBehaviorImpl(guildId, ruleId, kord)
 
+    /**
+     * Returns an [MentionSpamAutoModerationRuleBehavior] for a given [guildId].
+     *
+     * @param guildId The ID to create the [MentionSpamAutoModerationRuleBehavior] for
+     * @param ruleId The ID of the [MentionSpamAutoModerationRuleBehavior]
+     * @return The created [MentionSpamAutoModerationRuleBehaviorImpl]
+     */
     public fun mentionSpamAutoModerationRule(
         guildId: Snowflake,
         ruleId: Snowflake,
     ): MentionSpamAutoModerationRuleBehavior = MentionSpamAutoModerationRuleBehaviorImpl(guildId, ruleId, kord)
 
+    /**
+     * Returns a [MessageBehavior] for a given [messageId]
+     *
+     * @param channelId The ID of the channel the message was sent in
+     * @param messageId The ID of the message
+     * @return The [MessageBehavior] for the message
+     */
     public fun message(channelId: Snowflake, messageId: Snowflake): MessageBehavior =
         MessageBehavior(channelId = channelId, messageId = messageId, kord = kord)
 
+    /**
+     * Returns a [ChannelBehavior] for a given [id]
+     *
+     * @param id The ID of the channel
+     * @return The [ChannelBehavior] for the channel
+     */
     public fun channel(id: Snowflake): ChannelBehavior =
         ChannelBehavior(id, kord)
 
+    /**
+     * Returns a [MessageChannelBehavior] for a given [id]
+     *
+     * @param id The ID of the channel
+     * @return The [MessageChannelBehavior] for the channel
+     */
     public fun messageChannel(id: Snowflake): MessageChannelBehavior =
         MessageChannelBehavior(id, kord)
 
+    /**
+     * Returns a [TopGuildChannelBehavior] for a given [id]
+     *
+     * @param guildId The ID of the guild the channel is in
+     * @param id The ID of the channel
+     * @return The [TopGuildChannelBehavior] for the channel
+     */
     public fun topGuildChannel(guildId: Snowflake, id: Snowflake): TopGuildChannelBehavior =
         TopGuildChannelBehavior(guildId = guildId, id = id, kord = kord)
 
+    /**
+     * Returns a [CategorizableChannelBehavior] for a given [id]
+     *
+     * @param guildId The ID of the guild the channel is in
+     * @param id The ID of the channel
+     * @return The [CategorizableChannelBehavior] for the channel
+     */
     public fun categorizableChannel(guildId: Snowflake, id: Snowflake): CategorizableChannelBehavior =
         CategorizableChannelBehavior(guildId, id, kord)
 
+    /**
+     * Returns a [TopGuildMessageChannelBehavior] for a given [id]
+     *
+     * @param guildId The ID of the guild the channel is in
+     * @param id The ID of the channel
+     * @return The [TopGuildMessageChannelBehavior] for the channel
+     */
     public fun topGuildMessageChannel(guildId: Snowflake, id: Snowflake): TopGuildMessageChannelBehavior =
         TopGuildMessageChannelBehavior(guildId = guildId, id = id, kord = kord)
 
+    /**
+     * Returns a [GuildChannelBehavior] for a given [id]
+     *
+     * @param guildId The ID of the guild the channel is in
+     * @param id The ID of the channel
+     * @return The [GuildChannelBehavior] for the channel
+     */
     public fun guildChannel(guildId: Snowflake, id: Snowflake): GuildChannelBehavior =
         GuildChannelBehavior(guildId, id, kord)
 
+    /**
+     * Returns a [GuildMessageChannelBehavior] for a given [id]
+     *
+     * @param guildId The ID of the guild the channel is in
+     * @param id The ID of the channel
+     * @return The [GuildMessageChannelBehavior] for the channel
+     */
     public fun guildMessageChannel(guildId: Snowflake, id: Snowflake): GuildMessageChannelBehavior =
         GuildMessageChannelBehavior(guildId, id, kord)
 
+    /**
+     * Returns a [NewsChannelBehavior] for a given [id]
+     *
+     * @param guildId The ID of the guild the channel is in
+     * @param id The ID of the channel
+     * @return The [NewsChannelBehavior] for the channel
+     */
     public fun newsChannel(guildId: Snowflake, id: Snowflake): NewsChannelBehavior =
         NewsChannelBehavior(guildId = guildId, id = id, kord = kord)
 
+    /**
+     * Returns a [TextChannelBehavior] for a given [id]
+     *
+     * @param guildId The ID of the guild the channel is in
+     * @param id The ID of the channel
+     * @return The [TextChannelBehavior] for the channel
+     */
     public fun textChannel(guildId: Snowflake, id: Snowflake): TextChannelBehavior =
         TextChannelBehavior(guildId = guildId, id = id, kord = kord)
 
+    /**
+     * Returns a [VoiceChannelBehavior] for a given [id]
+     *
+     * @param guildId The ID of the guild the channel is in
+     * @param id The ID of the channel
+     * @return The [VoiceChannelBehavior] for the channel
+     */
     public fun voiceChannel(guildId: Snowflake, id: Snowflake): VoiceChannelBehavior =
         VoiceChannelBehavior(guildId = guildId, id = id, kord = kord)
 
+    /**
+     * Returns a [ThreadParentChannelBehavior] for a given [id]
+     *
+     * @param guildId The ID of the guild the thread parent is in
+     * @param id The ID of the channel
+     * @return The [ThreadParentChannelBehavior] for the channel
+     */
     public fun publicThreadParent(guildId: Snowflake, id: Snowflake): ThreadParentChannelBehavior =
         ThreadParentChannelBehavior(guildId, id, kord)
 
+    /**
+     * Returns a [PrivateThreadParentChannelBehavior] for a given [id]
+     *
+     * @param guildId The ID of the guild the thread parent is in
+     * @param id The ID of the channel
+     * @return The [PrivateThreadParentChannelBehavior] for the channel
+     */
     public fun privateThreadParent(guildId: Snowflake, id: Snowflake): PrivateThreadParentChannelBehavior =
         PrivateThreadParentChannelBehavior(guildId, id, kord)
 
+    /**
+     * Returns a [ThreadChannelBehavior] for a given [id]
+     *
+     * @param guildId The ID of the guild the thread parent is in
+     * @param parentId The ID of the parent channel for the thread
+     * @param id The ID of the channel
+     * @return The [ThreadChannelBehavior] for the channel
+     */
     public fun thread(guildId: Snowflake, parentId: Snowflake, id: Snowflake): ThreadChannelBehavior =
         ThreadChannelBehavior(guildId, parentId, id, kord)
 
-
+    /**
+     * Returns a [GuildBehavior] for a given [id]
+     *
+     * @param id The ID of the guild
+     * @return The [GuildBehavior] for the ID
+     */
     public fun guild(id: Snowflake): GuildBehavior =
         GuildBehavior(id, kord)
 
+    /**
+     * Returns a [GuildEmojiBehavior] for a given [id]
+     *
+     * @param guildId The ID of the guild the emoji is in
+     * @param id The ID of the emoji
+     * @param kord The Kord instance for the bot
+     * @return The [GuildEmojiBehavior] for the ID
+     */
     public fun guildEmoji(guildId: Snowflake, id: Snowflake, kord: Kord): GuildEmojiBehavior =
         GuildEmojiBehavior(guildId = guildId, id = id, kord = kord)
 
+    /**
+     * Returns a [RoleBehavior] for a given [id]
+     *
+     * @param guildId The ID of the guild the role is in
+     * @param id The ID of the role
+     * @return The [RoleBehavior] for the ID
+     */
     public fun role(guildId: Snowflake, id: Snowflake): RoleBehavior =
         RoleBehavior(guildId = guildId, id = id, kord = kord)
 
+    /**
+     * Returns a [UserBehavior] for a given [id]
+     *
+     * @param id The ID of the user
+     * @return The [UserBehavior] for the ID
+     */
     public fun user(id: Snowflake): UserBehavior =
         UserBehavior(id, kord)
 
+    /**
+     * Returns a [ThreadMemberBehavior] for a given [id]
+     *
+     * @param id The ID of the user
+     * @param threadId The ID of the thread
+     * @return The [ThreadMemberBehavior] for the ID
+     */
     public fun threadMember(id: Snowflake, threadId: Snowflake): ThreadMemberBehavior =
         ThreadMemberBehavior(id, threadId, kord)
 
+    /**
+     * Returns a [MemberBehavior] for a given [id]
+     *
+     * @param guildId The ID of the guild the member is in
+     * @param id The ID of the user
+     * @return The [MemberBehavior] for the ID
+     */
     public fun member(guildId: Snowflake, id: Snowflake): MemberBehavior =
         MemberBehavior(guildId = guildId, id = id, kord = kord)
 
+    /**
+     * Returns a [WebhookBehavior] for a given [id]
+     *
+     * @param id The ID of the guild
+     * @return The [WebhookBehavior] for the ID
+     */
     public fun webhook(id: Snowflake): WebhookBehavior =
         WebhookBehavior(id, kord)
 
+    /**
+     * Returns a [StageInstanceBehavior] for a given [id]
+     *
+     * @param id The ID of the stage instance
+     * @param channelId The ID of the channel the instance is in
+     * @return The [StageInstanceBehavior] for the ID
+     */
     public fun stageInstance(id: Snowflake, channelId: Snowflake): StageInstanceBehavior = StageInstanceBehavior(
         id, channelId, kord, kord.defaultSupplier
     )
 
+    /**
+     * Returns a [ApplicationCommandInteractionBehavior] for a given [id]
+     *
+     * @param id The ID of the application command
+     * @param channelId The ID of the channel the interaction took place in
+     * @param token The interactions token
+     * @param applicationId The ID of the application the interaction happened with
+     * @return The [ApplicationCommandInteractionBehavior] for the ID
+     */
     public fun applicationCommandInteraction(
         id: Snowflake,
         channelId: Snowflake,
@@ -123,7 +316,13 @@ public class Unsafe(private val kord: Kord) {
         return ApplicationCommandInteractionBehavior(id, channelId, token, applicationId, kord)
     }
 
-
+    /**
+     * Returns a [GlobalApplicationCommandBehavior] for a given [id]
+     *
+     * @param applicationId The ID of the application the interaction happened with
+     * @param id The ID of the application command
+     * @return The [GlobalApplicationCommandBehavior] for the ID
+     */
     public fun globalApplicationCommand(
         applicationId: Snowflake,
         id: Snowflake
@@ -132,6 +331,14 @@ public class Unsafe(private val kord: Kord) {
     }
 
 
+    /**
+     * Returns a [GuildApplicationCommandBehavior] for a given [id]
+     *
+     * @param applicationId The ID of the application the interaction happened with
+     * @param guildId The ID of the guild the interaction happened in
+     * @param id The ID of the application command
+     * @return The [GuildApplicationCommandBehavior] for the ID
+     */
     public fun globalApplicationCommand(
         applicationId: Snowflake,
         guildId: Snowflake,
@@ -145,6 +352,15 @@ public class Unsafe(private val kord: Kord) {
         return "Unsafe"
     }
 
+    /**
+     * Returns a [GuildApplicationCommandBehavior] for a given [commandId]
+     *
+     * @param guildId The ID of the guild the interaction happened in
+     * @param applicationId The ID of the application the interaction happened with
+     * @param commandId The ID of the application command
+     * @param service The interaction service for the command
+     * @return The [GuildApplicationCommandBehavior] for the ID
+     */
     public fun guildApplicationCommand(
         guildId: Snowflake,
         applicationId: Snowflake,
@@ -153,6 +369,14 @@ public class Unsafe(private val kord: Kord) {
     ): GuildApplicationCommandBehavior =
         GuildApplicationCommandBehavior(guildId, applicationId, commandId, service)
 
+    /**
+     * Returns a [GlobalApplicationCommandBehavior] for a given [commandId]
+     *
+     * @param applicationId The ID of the application the interaction happened with
+     * @param commandId The ID of the application command
+     * @param service The interaction service for the command
+     * @return The [GlobalApplicationCommandBehavior] for the ID
+     */
     public fun globalApplicationCommand(
         applicationId: Snowflake,
         commandId: Snowflake,
@@ -173,6 +397,13 @@ public class Unsafe(private val kord: Kord) {
         id, channelId, token, applicationId, kord
     )
 
+    /**
+     * Returns a [GuildScheduledEventBehavior] for a given [id]
+     *
+     * @param id The ID of the event
+     * @param guildId The ID of the event the guild is for
+     * @return The [GuildScheduledEventBehavior] for the ID
+     */
     public fun guildScheduledEvent(id: Snowflake, guildId: Snowflake): GuildScheduledEventBehavior =
         GuildScheduledEventBehavior(
             id,
diff --git a/core/src/commonMain/kotlin/behavior/ChatInputCommandBehavior.kt b/core/src/commonMain/kotlin/behavior/ChatInputCommandBehavior.kt
index 8cb456a69835..986ae7b1ed08 100644
--- a/core/src/commonMain/kotlin/behavior/ChatInputCommandBehavior.kt
+++ b/core/src/commonMain/kotlin/behavior/ChatInputCommandBehavior.kt
@@ -5,10 +5,16 @@ import dev.kord.core.entity.application.ChatInputCommandCommand
 import dev.kord.core.entity.application.GlobalChatInputCommand
 import dev.kord.core.entity.application.GuildChatInputCommand
 import dev.kord.rest.builder.interaction.ChatInputModifyBuilder
+import dev.kord.rest.request.RestRequestException
 
 
 public interface ChatInputCommandBehavior : ApplicationCommandBehavior {
 
+    /**
+     * Requests to edit this command
+     *
+     * @throws [RestRequestException] when something goes wrong during the request.
+     */
     public suspend fun edit(builder: suspend ChatInputModifyBuilder.() -> Unit): ChatInputCommandCommand
 
 }
diff --git a/core/src/commonMain/kotlin/behavior/GlobalApplicationCommandBehavior.kt b/core/src/commonMain/kotlin/behavior/GlobalApplicationCommandBehavior.kt
index 2c02ebd9632c..e4bc4ed50886 100644
--- a/core/src/commonMain/kotlin/behavior/GlobalApplicationCommandBehavior.kt
+++ b/core/src/commonMain/kotlin/behavior/GlobalApplicationCommandBehavior.kt
@@ -9,6 +9,7 @@ import dev.kord.rest.service.InteractionService
  * The behavior of an [Application Command](https://discord.com/developers/docs/interactions/application-commands).
  */
 public interface ApplicationCommandBehavior : Entity {
+    /** THe ID of the application. */
     public val applicationId: Snowflake
     public val service: InteractionService
 
diff --git a/core/src/commonMain/kotlin/behavior/GuildBehavior.kt b/core/src/commonMain/kotlin/behavior/GuildBehavior.kt
index efcb4287cd37..2d43cc22bffe 100644
--- a/core/src/commonMain/kotlin/behavior/GuildBehavior.kt
+++ b/core/src/commonMain/kotlin/behavior/GuildBehavior.kt
@@ -160,6 +160,13 @@ public interface GuildBehavior : KordEntity, Strategizable {
     public val members: Flow<Member>
         get() = supplier.getGuildMembers(id)
 
+    // TODO verify kdoc
+    /**
+     * Requests to get all present stickers for this guild.
+     *
+     * The returned flow is lazily executed, any [RestRequestException] will be thrown on
+     * [terminal operators](https://kotlinlang.org/docs/reference/coroutines/flow.html#terminal-flow-operators) instead.
+     */
     public val stickers: Flow<GuildSticker>
         get() = supplier.getGuildStickers(id)
 
@@ -211,6 +218,13 @@ public interface GuildBehavior : KordEntity, Strategizable {
             }
         }
 
+    // TODO verify kdoc
+    /**
+     * Requests to get all present templates for this guild.
+     *
+     * The returned flow is lazily executed, any [RestRequestException] will be thrown on
+     * [terminal operators](https://kotlinlang.org/docs/reference/coroutines/flow.html#terminal-flow-operators) instead.
+     */
     public val templates: Flow<Template>
         get() = supplier.getTemplates(id)
 
@@ -259,12 +273,36 @@ public interface GuildBehavior : KordEntity, Strategizable {
             }
     }
 
+    /**
+     * Gets the [GuildApplicationCommand]s for the application.
+     *
+     * @param withLocalizations Whether to get the commands with localizations or not. Defaults to `null`
+     * @return a [Flow] of [GuildApplicationCommand]s for the application.
+     * @throws RequestException if something went wrong during the request
+     * @throws EntityNotFoundException if the flow was null
+     */
     public fun getApplicationCommands(withLocalizations: Boolean? = null): Flow<GuildApplicationCommand> =
         supplier.getGuildApplicationCommands(kord.resources.applicationId, id, withLocalizations)
 
+    /**
+     * Gets a [GuildApplicationCommand] for the application based on the [commandId].
+     *
+     * @param commandId The ID of the command
+     * @return a [GuildApplicationCommand] for the given [commandId].
+     * @throws RequestException if something went wrong during the request
+     * @throws EntityNotFoundException if the flow was null
+     */
     public suspend fun getApplicationCommand(commandId: Snowflake): GuildApplicationCommand =
         supplier.getGuildApplicationCommand(kord.resources.applicationId, id, commandId)
 
+    /**
+     * Gets a [GuildApplicationCommand] for the application based on the [commandId].
+     * returns `null` if the command was not found
+     *
+     * @param commandId The ID of the command to get
+     * @return The [GuildApplicationCommand] or `null` if it was not found.
+     * @throws RequestException if something went wrong during the request
+     */
     public suspend fun getApplicationCommandOrNull(commandId: Snowflake): GuildApplicationCommand? =
         supplier.getGuildApplicationCommandOrNull(kord.resources.applicationId, id, commandId)
 
@@ -535,12 +573,34 @@ public interface GuildBehavior : KordEntity, Strategizable {
         return kord.rest.guild.beginGuildPrune(id, days, true, reason).pruned!!
     }
 
+    /**
+     * Gets the [WelcomeScreen] for the entity.
+     * returns `null` if the screen was not found
+     *
+     * @return The [WelcomeScreen] or `null`
+     * @throws RestRequestException when the request failed.
+     */
     public suspend fun getWelcomeScreenOrNull(): WelcomeScreen? =
         rest.supply(kord).getGuildWelcomeScreenOrNull(id)
 
+    /**
+     * Gets the [WelcomeScreen] for the entity.
+     *
+     * @return The [WelcomeScreen]
+     * @throws RestRequestException when the request failed.
+     * @throws EntityNotFoundException if the screen was null
+     */
     public suspend fun getWelcomeScreen(): WelcomeScreen =
         rest.supply(kord).getGuildWelcomeScreen(id)
 
+    /**
+     * Requests to edit the [WelcomeScreen].
+     *
+     * @param builder The [WelcomeScreenModifyBuilder] for the [WelcomeScreen]
+     *
+     * @return the updated [WelcomeScreen]
+     */
+    // This likely throws, what though?
     public suspend fun editWelcomeScreen(builder: WelcomeScreenModifyBuilder.() -> Unit): WelcomeScreen {
         val request = kord.rest.guild.modifyGuildWelcomeScreen(id, builder)
         val data = WelcomeScreenData.from(request)
@@ -599,19 +659,71 @@ public interface GuildBehavior : KordEntity, Strategizable {
     public suspend fun getGuildScheduledEventOrNull(eventId: Snowflake): GuildScheduledEvent? =
         supplier.getGuildScheduledEventOrNull(id, eventId)
 
+    /**
+     * Requests to get the widget of a [Guild] for the entity.
+     *
+     * @throws [RequestException] if anything went wrong during the request.
+     * @throws [EntityNotFoundException] if the [GuildWidget] wasn't present.
+     */
     public suspend fun getWidget(): GuildWidget = supplier.getGuildWidget(id)
 
+    /**
+     * Requests to get the widget of a [Guild] for the entity,
+     * returns null if the [GuildWidget] isn't present.
+     *
+     * @throws [RequestException] if anything went wrong during the request.
+     */
     public suspend fun getWidgetOrNull(): GuildWidget? = supplier.getGuildWidgetOrNull(id)
 
+    /**
+     * Requests the [Template] with the given [code].
+     * returns null when the template isn't present.
+     *
+     * @throws RequestException if something went wrong while retrieving the template.
+     * @throws EntityNotFoundException if template was null.
+     */
     public suspend fun getTemplate(code: String): Template = supplier.getTemplate(code)
 
+    /**
+     * Requests the [Template] with the given [code].
+     * returns null when the template isn't present.
+     *
+     * @throws RequestException if something went wrong while retrieving the template.
+     */
     public suspend fun getTemplateOrNull(code: String): Template? = supplier.getTemplateOrNull(code)
 
+    /**
+     * Gets a [GuildSticker] from a given [stickerId].
+     *
+     * @param stickerId The ID of the sticker to get
+     * @return The [GuildSticker] or throws an [EntityNotFoundException] if the sticker was not found
+     * @throws RequestException if something went wrong during the request
+     * @throws EntityNotFoundException if the sticker was null
+     */
     public suspend fun getSticker(stickerId: Snowflake): GuildSticker = supplier.getGuildSticker(id, stickerId)
 
+    /**
+     * Gets a [GuildSticker] from a given [stickerId].
+     * returns `null` if the sticker was not found
+     *
+     * @param stickerId The ID of the sticker to get
+     * @return The [GuildSticker] or null
+     * @throws RequestException if something went wrong during the request
+     */
     public suspend fun getStickerOrNull(stickerId: Snowflake): GuildSticker? =
         supplier.getGuildStickerOrNull(id, stickerId)
 
+    /**
+     * Requests to create a sticker for a guild.
+     *
+     * @param name The name of the sticker
+     * @param description The description of the sticker
+     * @param tags Any tags applied to the sticker
+     * @param file the sticker file.
+     *
+     * @return A [GuildSticker] object for the created sticker
+     */
+    // This likely throws, what?
     public suspend fun createSticker(name: String, description: String, tags: String, file: NamedFile): GuildSticker {
         val request = MultipartGuildStickerCreateRequest(GuildStickerCreateRequest(name, description, tags), file)
         val response = kord.rest.sticker.createGuildSticker(id, request)
@@ -658,11 +770,23 @@ public interface GuildBehavior : KordEntity, Strategizable {
     override fun withStrategy(strategy: EntitySupplyStrategy<*>): GuildBehavior = GuildBehavior(id, kord, strategy)
 }
 
+/**
+ * Requests the [GuildApplicationCommand] with the given [id] as type [T], returns null if the
+ * command application isn't present or if the channel is not of type [T].
+ *
+ * @throws RequestException if something went wrong while retrieving the application command.
+ */
 public suspend inline fun <reified T : GuildApplicationCommand> GuildBehavior.getApplicationCommandOfOrNull(commandId: Snowflake): T? {
     return supplier.getGuildApplicationCommandOfOrNull(kord.resources.applicationId, id, commandId)
 }
 
-
+/**
+ * Requests the [GuildApplicationCommand] with the given [id] as type [T].
+ *
+ * @throws RequestException if something went wrong while retrieving the guild application.
+ * @throws EntityNotFoundException if the guild application is null.
+ * @throws ClassCastException if the returned GuildApplication is not of type [T].
+ */
 public suspend inline fun <reified T : GuildApplicationCommand> GuildBehavior.getApplicationCommandOf(commandId: Snowflake): T {
     return supplier.getGuildApplicationCommandOf(kord.resources.applicationId, id, commandId)
 }
@@ -689,7 +813,15 @@ public fun GuildBehavior(
     }
 }
 
-
+/**
+ * Creates a [GuildChatInputCommand] for a given [id]
+ *
+ * @param name The name of the command
+ * @param description The description of the command
+ * @param builder A [ChatInputCreateBuilder] to modify the command
+ *
+ * @return a [GuildChatInputCommand] object for the command
+ */
 public suspend inline fun GuildBehavior.createChatInputCommand(
     name: String,
     description: String,
@@ -699,7 +831,14 @@ public suspend inline fun GuildBehavior.createChatInputCommand(
     return kord.createGuildChatInputCommand(id, name, description, builder)
 }
 
-
+/**
+ * Creates a [GuildMessageCommand] for a given [id]
+ *
+ * @param name The name of the command
+ * @param builder A [MessageCommandCreateBuilder] to modify the command
+ *
+ * @return a [GuildMessageCommand] object for the command
+ */
 public suspend inline fun GuildBehavior.createMessageCommand(
     name: String,
     builder: MessageCommandCreateBuilder.() -> Unit = {},
@@ -708,7 +847,14 @@ public suspend inline fun GuildBehavior.createMessageCommand(
     return kord.createGuildMessageCommand(id, name, builder)
 }
 
-
+/**
+ * Creates a [GuildUserCommand] for a given [id]
+ *
+ * @param name The name of the command
+ * @param builder A [UserCommandCreateBuilder] to modify the command
+ *
+ * @return a [GuildUserCommand] object for the command
+ */
 public suspend inline fun GuildBehavior.createUserCommand(
     name: String,
     builder: UserCommandCreateBuilder.() -> Unit = {},
@@ -717,7 +863,12 @@ public suspend inline fun GuildBehavior.createUserCommand(
     return kord.createGuildUserCommand(id, name, builder)
 }
 
-
+/**
+ * Creates multiple [GuildApplicationCommand]s.
+ *
+ * @param builder A [GuildMultiApplicationCommandBuilder] to create the commands in.
+ * @return A [Flow] of [GuildApplicationCommand]s for the bot.
+ */
 public suspend inline fun GuildBehavior.createApplicationCommands(
     builder: GuildMultiApplicationCommandBuilder.() -> Unit
 ): Flow<GuildApplicationCommand> {
@@ -742,6 +893,15 @@ public suspend inline fun GuildBehavior.edit(builder: GuildModifyBuilder.() -> U
     return Guild(data, kord)
 }
 
+/**
+ * Requests to create an emoji for the given guild [id].
+ *
+ * @param name The name of the emoji
+ * @param image The [Image] for the emoji
+ * @param builder The [EmojiCreateBuilder] for the emoji
+ *
+ * @return A [GuildEmoji] object for the emoji
+ */
 public suspend inline fun GuildBehavior.createEmoji(
     name: String,
     image: Image,
@@ -761,7 +921,6 @@ public suspend inline fun GuildBehavior.createEmoji(
  *
  * @throws [RestRequestException] if something went wrong during the request.
  */
-
 public suspend inline fun GuildBehavior.createTextChannel(
     name: String,
     builder: TextChannelCreateBuilder.() -> Unit = {}
@@ -775,6 +934,13 @@ public suspend inline fun GuildBehavior.createTextChannel(
     return Channel.from(data, kord) as TextChannel
 }
 
+/**
+ * Requests to create a new forum channel.
+ *
+ * @return The created [ForumChannel].
+ *
+ * @throws [RestRequestException] if something went wrong during the request.
+ */
 public suspend inline fun GuildBehavior.createForumChannel(
     name: String,
     builder: ForumChannelCreateBuilder.() -> Unit = {}
@@ -785,6 +951,13 @@ public suspend inline fun GuildBehavior.createForumChannel(
     return Channel.from(data, kord) as ForumChannel
 }
 
+/**
+ * Requests to create a new media channel.
+ *
+ * @return The created [MediaChannel].
+ *
+ * @throws [RestRequestException] if something went wrong during the request.
+ */
 public suspend inline fun GuildBehavior.createMediaChannel(
     name: String,
     builder: MediaChannelCreateBuilder.() -> Unit = {},
@@ -855,7 +1028,6 @@ public suspend inline fun GuildBehavior.createStageChannel(
     return Channel.from(data, kord) as StageChannel
 }
 
-
 /**
  * Requests to create a new category.
  *
@@ -964,6 +1136,11 @@ public suspend inline fun <reified T : GuildChannel> GuildBehavior.getChannelOfO
     return channel
 }
 
+/**
+ * Requests to edit the [GuildWidget] object of the guild and returns the edited widget object.
+ *
+ * @throws RestRequestException if something went wrong during the request
+ */
 public suspend inline fun GuildBehavior.editWidget(builder: GuildWidgetModifyBuilder.() -> Unit): GuildWidget {
     contract { callsInPlace(builder, EXACTLY_ONCE) }
     return GuildWidget(GuildWidgetData.from(kord.rest.guild.modifyGuildWidget(id, builder)), id, kord)
diff --git a/core/src/commonMain/kotlin/behavior/GuildEmojiBehavior.kt b/core/src/commonMain/kotlin/behavior/GuildEmojiBehavior.kt
index d71f3aa431bc..449ac91b34dd 100644
--- a/core/src/commonMain/kotlin/behavior/GuildEmojiBehavior.kt
+++ b/core/src/commonMain/kotlin/behavior/GuildEmojiBehavior.kt
@@ -15,12 +15,12 @@ import kotlin.contracts.InvocationKind
 import kotlin.contracts.contract
 
 /**
- * The behavior of a [Discord Emoij](https://discord.com/developers/docs/resources/emoji).
+ * The behavior of a [Discord Emoji](https://discord.com/developers/docs/resources/emoji).
  */
 public interface GuildEmojiBehavior : KordEntity, Strategizable {
 
     /**
-     * The id of the guild this emojis is part of.
+     * The id of the guild this emoji is part of.
      */
     public val guildId: Snowflake
 
diff --git a/core/src/commonMain/kotlin/behavior/channel/CategoryBehavior.kt b/core/src/commonMain/kotlin/behavior/channel/CategoryBehavior.kt
index b492f5a6a013..cba47f6ad6b6 100644
--- a/core/src/commonMain/kotlin/behavior/channel/CategoryBehavior.kt
+++ b/core/src/commonMain/kotlin/behavior/channel/CategoryBehavior.kt
@@ -126,6 +126,9 @@ public suspend fun CategoryBehavior.edit(builder: CategoryModifyBuilder.() -> Un
 /**
  * Requests to create a new text channel with this category as parent.
  *
+ * @param name The name of the text channel
+ * @param builder The [TextChannelCreateBuilder] for the channel
+ *
  * @return The created [TextChannel].
  *
  * @throws [RestRequestException] if something went wrong during the request.
@@ -150,6 +153,9 @@ public suspend inline fun CategoryBehavior.createTextChannel(
 /**
  * Requests to create a new voice channel with this category as parent.
  *
+ * @param name The name of the voice channel
+ * @param builder The [VoiceChannelCreateBuilder] for the channel
+ *
  * @return The created [VoiceChannel].
  *
  * @throws [RestRequestException] if something went wrong during the request.
@@ -173,6 +179,9 @@ public suspend inline fun CategoryBehavior.createVoiceChannel(
 /**
  * Requests to create a new news channel with this category as parent.
  *
+ * @param name The name of the news channel
+ * @param builder The [NewsChannelCreateBuilder] for the channel
+ *
  * @return The created [NewsChannel].
  *
  * @throws [RestRequestException] if something went wrong during the request.
@@ -196,6 +205,9 @@ public suspend inline fun CategoryBehavior.createNewsChannel(
 /**
  * Requests to create a new stage channel with this category as parent.
  *
+ * @param name The name of the new stage channel
+ * @param builder The [StageChannelCreateBuilder] for the channel
+ *
  * @return The created [StageChannel].
  *
  * @throws [RestRequestException] if something went wrong during the request.
diff --git a/core/src/commonMain/kotlin/behavior/channel/GuildMessageChannelBehavior.kt b/core/src/commonMain/kotlin/behavior/channel/GuildMessageChannelBehavior.kt
index 1e46591fb8e8..2e9087491938 100644
--- a/core/src/commonMain/kotlin/behavior/channel/GuildMessageChannelBehavior.kt
+++ b/core/src/commonMain/kotlin/behavior/channel/GuildMessageChannelBehavior.kt
@@ -21,7 +21,7 @@ public interface GuildMessageChannelBehavior : GuildChannelBehavior, MessageChan
      * Requests to bulk delete the [messages].
      *
      * If [deleteOlderMessages] is `true` (default), messages older than 14
-     * days will be deleted individually. Otherwise they will be ignored.
+     * days will be deleted individually. Otherwise, they will be ignored.
      *
      * @param reason the reason showing up in the audit log
      * @throws [RestRequestException] if something went wrong during the request.
diff --git a/core/src/commonMain/kotlin/behavior/channel/NewsChannelBehavior.kt b/core/src/commonMain/kotlin/behavior/channel/NewsChannelBehavior.kt
index 800896a6058d..6d082b94a518 100644
--- a/core/src/commonMain/kotlin/behavior/channel/NewsChannelBehavior.kt
+++ b/core/src/commonMain/kotlin/behavior/channel/NewsChannelBehavior.kt
@@ -37,7 +37,7 @@ public interface NewsChannelBehavior : TopGuildMessageChannelBehavior, ThreadPar
         get() = super.activeThreads.filterIsInstance()
 
     /**
-     * Requests to get the this behavior as a [NewsChannel].
+     * Requests to get this behavior as a [NewsChannel].
      *
      * @throws [RequestException] if something went wrong during the request.
      * @throws [EntityNotFoundException] if the channel wasn't present.
@@ -82,6 +82,16 @@ public interface NewsChannelBehavior : TopGuildMessageChannelBehavior, ThreadPar
         kord.rest.channel.followNewsChannel(id, ChannelFollowRequest(webhookChannelId = target))
     }
 
+    /**
+     * Starts a [NewsChannelThread] with a given [name] and properties provided from the [builder]
+     *
+     * @param name The name of the thread
+     * @param builder The [StartThreadBuilder] for the thread
+     *
+     * @return A [NewsChannelThread] object for the thread.
+     *
+     * @throws [RequestException] if something went wrong during the request.
+     */
     public suspend fun startPublicThread(
         name: String,
         builder: StartThreadBuilder.() -> Unit = {},
@@ -89,6 +99,17 @@ public interface NewsChannelBehavior : TopGuildMessageChannelBehavior, ThreadPar
         return unsafeStartThread(name, type = ChannelType.PublicNewsThread, builder) as NewsChannelThread
     }
 
+    /**
+     * Starts a [NewsChannelThread] with a message from a [messageId], a given [name] and properties provided from the [builder]
+     *
+     * @param messageId The ID of the message that starts the thread
+     * @param name The name of the thread
+     * @param builder The [StartThreadWithMessageBuilder] for the thread
+     *
+     * @return A [NewsChannelThread] object for the thread.
+     *
+     * @throws [RequestException] if something went wrong during the request.
+     */
     public suspend fun startPublicThreadWithMessage(
         messageId: Snowflake,
         name: String,
diff --git a/core/src/commonMain/kotlin/behavior/channel/StageChannelBehavior.kt b/core/src/commonMain/kotlin/behavior/channel/StageChannelBehavior.kt
index e7a06570247c..c4d633eb5ad1 100644
--- a/core/src/commonMain/kotlin/behavior/channel/StageChannelBehavior.kt
+++ b/core/src/commonMain/kotlin/behavior/channel/StageChannelBehavior.kt
@@ -1,12 +1,15 @@
 package dev.kord.core.behavior.channel
 
 import dev.kord.common.entity.Snowflake
+import dev.kord.common.exception.RequestException
 import dev.kord.core.Kord
 import dev.kord.core.cache.data.ChannelData
 import dev.kord.core.cache.data.StageInstanceData
 import dev.kord.core.entity.StageInstance
 import dev.kord.core.entity.channel.Channel
 import dev.kord.core.entity.channel.StageChannel
+import dev.kord.core.entity.channel.TextChannel
+import dev.kord.core.exception.EntityNotFoundException
 import dev.kord.core.supplier.EntitySupplier
 import dev.kord.core.supplier.EntitySupplyStrategy
 import dev.kord.rest.builder.channel.StageVoiceChannelModifyBuilder
@@ -31,12 +34,37 @@ public interface StageChannelBehavior : BaseVoiceChannelBehavior, TopGuildMessag
         return StageChannelBehavior(id, guildId, kord, strategy.supply(kord))
     }
 
+    /**
+     * Requests to get [StageInstance] for the given channel id. Returns null when the instance is not present.
+     *
+     * @return A nullable [StageInstance] for the given channel
+     *
+     * @throws [RequestException] if something went wrong during the request
+     */
     public suspend fun getStageInstanceOrNull(): StageInstance? = supplier.getStageInstanceOrNull(id)
 
+    /**
+     * Requests the [StageInstance]s for a channel.
+     *
+     * @return a [StageInstance] for the given channel.
+     *
+     * @throws RequestException if something went wrong during the request
+     * @throws EntityNotFoundException if the state instance was null
+     */
     public suspend fun getStageInstance(): StageInstance = supplier.getStageInstance(id)
 
 }
 
+/**
+ * Requests to create a new stage instance.
+ *
+ * @param topic The stage instance topic
+ * @param builder The builder for the stage instance
+ *
+ * @return The created [StageInstance].
+ *
+ * @throws [RestRequestException] if something went wrong during the request.
+ */
 public suspend inline fun StageChannelBehavior.createStageInstance(
     topic: String,
     builder: StageInstanceCreateBuilder.() -> Unit = {},
diff --git a/core/src/commonMain/kotlin/behavior/channel/TextChannelBehavior.kt b/core/src/commonMain/kotlin/behavior/channel/TextChannelBehavior.kt
index 63d15d744c2d..4be6627dbb5f 100644
--- a/core/src/commonMain/kotlin/behavior/channel/TextChannelBehavior.kt
+++ b/core/src/commonMain/kotlin/behavior/channel/TextChannelBehavior.kt
@@ -10,6 +10,7 @@ import dev.kord.core.behavior.channel.threads.unsafeStartThread
 import dev.kord.core.cache.data.ChannelData
 import dev.kord.core.entity.channel.Channel
 import dev.kord.core.entity.channel.TextChannel
+import dev.kord.core.entity.channel.thread.NewsChannelThread
 import dev.kord.core.entity.channel.thread.TextChannelThread
 import dev.kord.core.exception.EntityNotFoundException
 import dev.kord.core.hash
@@ -65,6 +66,16 @@ public interface TextChannelBehavior : TopGuildMessageChannelBehavior, PrivateTh
      */
     override suspend fun fetchChannelOrNull(): TextChannel? = super<TopGuildMessageChannelBehavior>.fetchChannelOrNull() as? TextChannel
 
+    /**
+     * Starts a public [TextChannelThread] with  a given [name] and properties provided from the [builder]
+     *
+     * @param name The name of the thread
+     * @param builder The [StartThreadBuilder] for the thread
+     *
+     * @return A [TextChannelThread] object for the thread.
+     *
+     * @throws [RequestException] if something went wrong during the request.
+     */
     public suspend fun startPublicThread(
         name: String,
         builder: StartThreadBuilder.() -> Unit = {},
@@ -72,6 +83,16 @@ public interface TextChannelBehavior : TopGuildMessageChannelBehavior, PrivateTh
         return unsafeStartThread(name, type = ChannelType.PublicGuildThread, builder) as TextChannelThread
     }
 
+    /**
+     * Starts a private [TextChannelThread] with  a given [name] and properties provided from the [builder]
+     *
+     * @param name The name of the thread
+     * @param builder The [StartThreadBuilder] for the thread
+     *
+     * @return A [TextChannelThread] object for the thread.
+     *
+     * @throws [RequestException] if something went wrong during the request.
+     */
     public suspend fun startPrivateThread(
         name: String,
         builder: StartThreadBuilder.() -> Unit = {},
@@ -79,6 +100,17 @@ public interface TextChannelBehavior : TopGuildMessageChannelBehavior, PrivateTh
         return unsafeStartThread(name, type = ChannelType.PrivateThread, builder) as TextChannelThread
     }
 
+    /**
+     * Starts a [TextChannelThread] with a message from a [messageId], a given [name] and properties provided from the [builder]
+     *
+     * @param messageId The ID of the message that starts the thread
+     * @param name The name of the thread
+     * @param builder The [StartThreadWithMessageBuilder] for the thread
+     *
+     * @return A [TextChannelThread] object for the thread.
+     *
+     * @throws [RequestException] if something went wrong during the request.
+     */
     public suspend fun startPublicThreadWithMessage(
         messageId: Snowflake,
         name: String,
diff --git a/core/src/commonMain/kotlin/behavior/channel/TopGuildMessageChannelBehavior.kt b/core/src/commonMain/kotlin/behavior/channel/TopGuildMessageChannelBehavior.kt
index 37feefa191e6..09e8bcd61d02 100644
--- a/core/src/commonMain/kotlin/behavior/channel/TopGuildMessageChannelBehavior.kt
+++ b/core/src/commonMain/kotlin/behavior/channel/TopGuildMessageChannelBehavior.kt
@@ -18,7 +18,7 @@ import dev.kord.core.supplier.EntitySupplyStrategy
 public interface TopGuildMessageChannelBehavior : CategorizableChannelBehavior, GuildMessageChannelBehavior {
 
     /**
-     * Requests to get the this behavior as a [TopGuildMessageChannel].
+     * Requests to get this behavior as a [TopGuildMessageChannel].
      *
      * @throws [RequestException] if something went wrong during the request.
      * @throws [EntityNotFoundException] if the channel wasn't present.
diff --git a/core/src/commonMain/kotlin/behavior/channel/VoiceChannelBehavior.kt b/core/src/commonMain/kotlin/behavior/channel/VoiceChannelBehavior.kt
index 0c1b1ed48748..15adfb62e026 100644
--- a/core/src/commonMain/kotlin/behavior/channel/VoiceChannelBehavior.kt
+++ b/core/src/commonMain/kotlin/behavior/channel/VoiceChannelBehavior.kt
@@ -22,7 +22,7 @@ import kotlin.contracts.contract
 public interface VoiceChannelBehavior : TopGuildMessageChannelBehavior, BaseVoiceChannelBehavior {
 
     /**
-     * Requests to get the this behavior as a [VoiceChannel].
+     * Requests to get this behavior as a [VoiceChannel].
      *
      * @throws [RequestException] if anything went wrong during the request.
      * @throws [EntityNotFoundException] if the channel wasn't present.
diff --git a/core/src/commonMain/kotlin/behavior/channel/threads/ThreadChannelBehavior.kt b/core/src/commonMain/kotlin/behavior/channel/threads/ThreadChannelBehavior.kt
index eca052dd8ed1..56fe3ca991b9 100644
--- a/core/src/commonMain/kotlin/behavior/channel/threads/ThreadChannelBehavior.kt
+++ b/core/src/commonMain/kotlin/behavior/channel/threads/ThreadChannelBehavior.kt
@@ -61,7 +61,7 @@ public interface ThreadChannelBehavior : GuildMessageChannelBehavior {
     }
 
     /**
-     * Join the the current thread.
+     * Join the current thread.
      * Requires the thread is not locked.
      * or current bot has [Manage Threads][dev.kord.common.entity.Permission.ManageThreads] permission
      *
diff --git a/core/src/commonMain/kotlin/behavior/interaction/GuildInteractionBehavior.kt b/core/src/commonMain/kotlin/behavior/interaction/GuildInteractionBehavior.kt
index 9f74e69cd49c..ada19e203995 100644
--- a/core/src/commonMain/kotlin/behavior/interaction/GuildInteractionBehavior.kt
+++ b/core/src/commonMain/kotlin/behavior/interaction/GuildInteractionBehavior.kt
@@ -1,12 +1,14 @@
 package dev.kord.core.behavior.interaction
 
 import dev.kord.common.entity.Snowflake
+import dev.kord.common.exception.RequestException
 import dev.kord.core.Kord
 import dev.kord.core.behavior.GuildBehavior
 import dev.kord.core.behavior.channel.GuildMessageChannelBehavior
 import dev.kord.core.entity.Guild
 import dev.kord.core.entity.channel.GuildMessageChannel
 import dev.kord.core.entity.interaction.GuildInteraction
+import dev.kord.core.exception.EntityNotFoundException
 import dev.kord.core.supplier.EntitySupplier
 import dev.kord.core.supplier.EntitySupplyStrategy
 import dev.kord.core.supplier.getChannelOf
@@ -24,8 +26,19 @@ public interface GuildInteractionBehavior : InteractionBehavior {
     override val channel: GuildMessageChannelBehavior
         get() = GuildMessageChannelBehavior(guildId, channelId, kord)
 
+    /**
+     * Requests the [Guild] for the interaction, returns `null` when the guild isn't present.
+     *
+     * @throws RequestException if something went wrong while retrieving the guild.
+     */
     public suspend fun getGuildOrNull(): Guild? = supplier.getGuildOrNull(guildId)
 
+    /**
+     * Requests the [Guild] for the interaction.
+     *
+     * @throws RequestException if something went wrong while retrieving the guild.
+     * @throws EntityNotFoundException if the guild is null.
+     */
     public suspend fun getGuild(): Guild = supplier.getGuild(guildId)
 
     override suspend fun getChannel(): GuildMessageChannel = supplier.getChannelOf(channelId)
diff --git a/core/src/commonMain/kotlin/behavior/interaction/InteractionBehavior.kt b/core/src/commonMain/kotlin/behavior/interaction/InteractionBehavior.kt
index ca8bd0b6cb8f..9e5682771ae4 100644
--- a/core/src/commonMain/kotlin/behavior/interaction/InteractionBehavior.kt
+++ b/core/src/commonMain/kotlin/behavior/interaction/InteractionBehavior.kt
@@ -1,11 +1,14 @@
 package dev.kord.core.behavior.interaction
 
 import dev.kord.common.entity.Snowflake
+import dev.kord.common.exception.RequestException
 import dev.kord.core.behavior.channel.MessageChannelBehavior
 import dev.kord.core.entity.KordEntity
 import dev.kord.core.entity.Strategizable
+import dev.kord.core.entity.channel.Channel
 import dev.kord.core.entity.channel.MessageChannel
 import dev.kord.core.entity.interaction.Interaction
+import dev.kord.core.exception.EntityNotFoundException
 import dev.kord.core.supplier.EntitySupplyStrategy
 import dev.kord.core.supplier.getChannelOf
 import dev.kord.core.supplier.getChannelOfOrNull
@@ -25,8 +28,21 @@ public interface InteractionBehavior : KordEntity, Strategizable {
     /** The behavior of the channel the interaction was sent from. */
     public val channel: MessageChannelBehavior get() = MessageChannelBehavior(channelId, kord)
 
+    /**
+     * Requests the [Channel] for the interaction as a [MessageChannel], returns null if the
+     * channel isn't present or if the channel is not a [MessageChannel].
+     *
+     * @throws RequestException if something went wrong while retrieving the channel.
+     */
     public suspend fun getChannelOrNull(): MessageChannel? = supplier.getChannelOfOrNull(channelId)
 
+    /**
+     * Requests the [Channel] for the interaction as a [MessageChannel].
+     *
+     * @throws RequestException if something went wrong while retrieving the channel.
+     * @throws EntityNotFoundException if the channel is null.
+     * @throws ClassCastException if the returned Channel is not of type [MessageChannel].
+     */
     public suspend fun getChannel(): MessageChannel = supplier.getChannelOf(channelId)
 
     override fun withStrategy(strategy: EntitySupplyStrategy<*>): InteractionBehavior
diff --git a/core/src/commonMain/kotlin/behavior/interaction/followup/FollowupMessageBehavior.kt b/core/src/commonMain/kotlin/behavior/interaction/followup/FollowupMessageBehavior.kt
index 264bb129b278..3b32d125c758 100644
--- a/core/src/commonMain/kotlin/behavior/interaction/followup/FollowupMessageBehavior.kt
+++ b/core/src/commonMain/kotlin/behavior/interaction/followup/FollowupMessageBehavior.kt
@@ -1,6 +1,7 @@
 package dev.kord.core.behavior.interaction.followup
 
 import dev.kord.common.entity.Snowflake
+import dev.kord.common.exception.RequestException
 import dev.kord.core.behavior.channel.MessageChannelBehavior
 import dev.kord.core.cache.data.toData
 import dev.kord.core.entity.KordEntity
@@ -10,6 +11,7 @@ import dev.kord.core.entity.channel.MessageChannel
 import dev.kord.core.entity.interaction.followup.EphemeralFollowupMessage
 import dev.kord.core.entity.interaction.followup.FollowupMessage
 import dev.kord.core.entity.interaction.followup.PublicFollowupMessage
+import dev.kord.core.exception.EntityNotFoundException
 import dev.kord.core.supplier.EntitySupplyStrategy
 import dev.kord.core.supplier.getChannelOf
 import dev.kord.core.supplier.getChannelOfOrNull
@@ -23,14 +25,33 @@ import kotlin.contracts.contract
  */
 public interface FollowupMessageBehavior : KordEntity, Strategizable {
 
+    /** The ID of the application making the request. */
     public val applicationId: Snowflake
+
+    /** The continuation token for responding to the interaction. */
     public val token: String
+
+    /** The ID of the channel the followup message was within. */
     public val channelId: Snowflake
 
+    /** The channel as a [MessageChannelBehavior] object. */
     public val channel: MessageChannelBehavior get() = MessageChannelBehavior(channelId, kord)
 
+    /**
+     * Requests the channel as a [MessageChannel].
+     *
+     * @throws RequestException if something went wrong while retrieving the channel.
+     * @throws EntityNotFoundException if the channel is null.
+     * @throws ClassCastException if the returned Channel is not of type [MessageChannel].
+     */
     public suspend fun getChannel(): MessageChannel = supplier.getChannelOf(channelId)
 
+    /**
+     * Requests the channel as a [MessageChannel], returns null if the channel isn't present or if the channel is not a
+     * [MessageChannel]
+     *
+     * @throws RequestException if something went wrong while retrieving the channel.
+     */
     public suspend fun getChannelOrNull(): MessageChannel? = supplier.getChannelOfOrNull(channelId)
 
     /**
diff --git a/core/src/commonMain/kotlin/builder/components/ButtonBuilderExtensions.kt b/core/src/commonMain/kotlin/builder/components/ButtonBuilderExtensions.kt
index e634061dcb17..710bd3face2b 100644
--- a/core/src/commonMain/kotlin/builder/components/ButtonBuilderExtensions.kt
+++ b/core/src/commonMain/kotlin/builder/components/ButtonBuilderExtensions.kt
@@ -6,15 +6,29 @@ import dev.kord.core.entity.GuildEmoji
 import dev.kord.core.entity.ReactionEmoji
 import dev.kord.rest.builder.component.ButtonBuilder
 
-
+/**
+ * Sets the emoji that appears on the button.
+ *
+ * @param emoji The [ReactionEmoji.Unicode] for the emoji
+ */
 public fun ButtonBuilder.emoji(emoji: ReactionEmoji.Unicode) {
     this.emoji = DiscordPartialEmoji(name = emoji.name, id = null)
 }
 
+/**
+ * Sets the emoji that appears on the button.
+ *
+ * @param emoji The [ReactionEmoji.Custom] for the emoji
+ */
 public fun ButtonBuilder.emoji(emoji: ReactionEmoji.Custom) {
     this.emoji = DiscordPartialEmoji(name = emoji.name, id = emoji.id, animated = emoji.isAnimated.optional())
 }
 
+/**
+ * Sets the emoji that appears on the button.
+ *
+ * @param emoji The [GuildEmoji] for the emoji
+ */
 public fun ButtonBuilder.emoji(emoji: GuildEmoji) {
     this.emoji = DiscordPartialEmoji(id = emoji.id, name = null, animated = emoji.isAnimated.optional())
 }
diff --git a/core/src/commonMain/kotlin/builder/kord/KordBuilder.kt b/core/src/commonMain/kotlin/builder/kord/KordBuilder.kt
index 04272a756334..f037c0b43b4d 100644
--- a/core/src/commonMain/kotlin/builder/kord/KordBuilder.kt
+++ b/core/src/commonMain/kotlin/builder/kord/KordBuilder.kt
@@ -37,8 +37,14 @@ import kotlinx.serialization.json.Json
 
 private val gatewayInfoJson = Json { ignoreUnknownKeys = true }
 
+/**
+ * The builder for the [Kord] instance.
+ *
+ * @property token The bots token
+ */
 public expect class KordBuilder(token: String) : BaseKordBuilder
 
+/** @see KordBuilder */
 public abstract class BaseKordBuilder internal constructor(public val token: String) {
     private var shardsBuilder: (recommended: Int) -> Shards = { Shards(it) }
     private var gatewayBuilder: (resources: ClientResources, shards: List<Int>) -> List<Gateway> =
@@ -93,6 +99,9 @@ public abstract class BaseKordBuilder internal constructor(public val token: Str
      */
     public var httpClient: HttpClient? = null
 
+    /**
+     * The [Snowflake] ID for the application.
+     */
     public var applicationId: Snowflake? = null
 
     /**
@@ -203,6 +212,8 @@ public abstract class BaseKordBuilder internal constructor(public val token: Str
     }
 
     /**
+     * Builds the [Kord] instance
+     *
      * @throws KordInitializationException if something went wrong while getting the bot's gateway information.
      */
     public open suspend fun build(): Kord = buildBase()
diff --git a/core/src/commonMain/kotlin/builder/kord/RestOnlyBuilder.kt b/core/src/commonMain/kotlin/builder/kord/RestOnlyBuilder.kt
index 9d240dc75cf2..30cd98cb66d9 100644
--- a/core/src/commonMain/kotlin/builder/kord/RestOnlyBuilder.kt
+++ b/core/src/commonMain/kotlin/builder/kord/RestOnlyBuilder.kt
@@ -19,6 +19,9 @@ import kotlinx.coroutines.Dispatchers
 import kotlinx.coroutines.ExperimentalCoroutinesApi
 import kotlinx.coroutines.flow.MutableSharedFlow
 
+/**
+ * The Builder for the RestOnly client
+ */
 public abstract class RestOnlyBuilder {
     protected var handlerBuilder: (resources: ClientResources) -> RequestHandler =
         { KtorRequestHandler(it.httpClient, ExclusionRequestRateLimiter(), token = it.token) }
@@ -36,6 +39,9 @@ public abstract class RestOnlyBuilder {
      */
     public var httpClient: HttpClient? = null
 
+    /**
+     * The [Snowflake] ID for the application
+     */
     public abstract var applicationId: Snowflake
 
     /**
@@ -51,6 +57,9 @@ public abstract class RestOnlyBuilder {
         this.handlerBuilder = handlerBuilder
     }
 
+    /**
+     * Builds the rest only [Kord] instance
+     */
     public fun build(): Kord {
         val client = httpClient.configure()
         val selfId = applicationId
diff --git a/core/src/commonMain/kotlin/entity/Embed.kt b/core/src/commonMain/kotlin/entity/Embed.kt
index d22a4a94a090..599270980fe4 100644
--- a/core/src/commonMain/kotlin/entity/Embed.kt
+++ b/core/src/commonMain/kotlin/entity/Embed.kt
@@ -12,113 +12,149 @@ import kotlinx.datetime.Instant
 
 /**
  * An instance of a [Discord Embed](https://discord.com/developers/docs/resources/channel#embed-object).
+ *
+ * @param data The [EmbedData] for the embed
  */
 public data class Embed(val data: EmbedData, override val kord: Kord) : KordObject {
 
-    /**
-     * The title, if present.
-     */
+    /** The title, if present. */
     public val title: String? get() = data.title.value
 
     /** The type of embed, if present. Always [Rich][EmbedType.Rich] for webhook embeds. */
     val type: EmbedType? get() = data.type.value
 
-    /**
-     * The description, if present.
-     */
+    /** The description, if present. */
     val description: String? get() = data.description.value
 
-    /**
-     * The title url, if present.
-     */
+    /** The title url, if present. */
     val url: String? get() = data.url.value
 
-    /**
-     * The timestamp, if present. Unrelated to the creation time of the embed.
-     */
+    /** The timestamp, if present. Unrelated to the creation time of the embed. */
     val timestamp: Instant? get() = data.timestamp.value
 
-    /**
-     * The color of the embed, if present.
-     */
+    /** The color of the embed, if present. */
     val color: Color? get() = data.color.value?.let { Color(it) }
 
-    /**
-     * The footer, if present.
-     */
+    /** The footer, if present. */
     val footer: Footer? get() = data.footer.value?.let { Footer(it, kord) }
 
-    /**
-     * The image, if present.
-     */
+    /** The image, if present. */
     val image: Image? get() = data.image.value?.let { Image(it, kord) }
 
-    /**
-     * The thumbnail, if present.
-     */
+    /** The thumbnail, if present. */
     val thumbnail: Thumbnail? get() = data.thumbnail.value?.let { Thumbnail(it, kord) }
 
-    /**
-     * The embedded video, if present.
-     */
+    /** The embedded video, if present. */
     val video: Video? get() = data.video.value?.let { Video(it, kord) }
 
-    /**
-     * The embed provider, if present.
-     */
+    /** The embed provider, if present. */
     val provider: Provider? get() = data.provider.value?.let { Provider(it, kord) }
 
-    /**
-     * The embed author, if present.
-     */
+    /** The embed author, if present. */
     val author: Author? get() = data.author.value?.let { Author(it, kord) }
 
-    /**
-     * The embed fields.
-     */
+    /** The embed fields. */
     val fields: List<Field> get() = data.fields.orEmpty().map { Field(it, kord) }
 
+    /**
+     * Represents an Embed Footer.
+     *
+     * @param data The [EmbedFooterData] for the footer
+     */
     public data class Footer(val data: EmbedFooterData, override val kord: Kord) : KordObject {
+        /** The text for the footer. */
         val text: String get() = data.text
+        /** The Icon URL for the footer. */
         val iconUrl: String? get() = data.iconUrl.value
+        /** The proxy Icon URL for the footer. */
         val proxyIconUrl: String? get() = data.proxyIconUrl.value
     }
 
+    /**
+     * Represents an Image in an embed.
+     *
+     * @param data the [EmbedImageData] for the image.
+     */
     public data class Image(val data: EmbedImageData, override val kord: Kord) : KordObject {
+        /** The URL for the image. */
         val url: String? get() = data.url.value
+        /** The proxy URL for the image. */
         val proxyUrl: String? get() = data.proxyUrl.value
+        /** The height of the image. */
         val height: Int? get() = data.height.value
+        /** The width of the image. */
         val width: Int? get() = data.width.value
     }
 
+    /**
+     * Represents a thumbnail in an embed.
+     *
+     * @param data the [EmbedThumbnailData] for the thumbnail.
+     */
     public data class Thumbnail(val data: EmbedThumbnailData, override val kord: Kord) : KordObject {
+        /** The URL for the thumbnail. */
         val url: String? get() = data.url.value
+        /** The proxy URL for the thumbnail. */
         val proxyUrl: String? get() = data.proxyUrl.value
+        /** The height of the thumbnail. */
         val height: Int? get() = data.height.value
+        /** The width of the thumbnail. */
         val width: Int? get() = data.width.value
     }
 
+    /**
+     * Represents a video in an embed.
+     *
+     * @param data the [EmbedVideoData] for the video.
+     */
     public data class Video(val data: EmbedVideoData, override val kord: Kord) : KordObject {
+        /** The URL For the video*/
         val url: String? get() = data.url.value
+        /** The height of the video. */
         val height: Int? get() = data.height.value
+        /** The width of the video. */
         val width: Int? get() = data.width.value
     }
 
+    /**
+     * Represents a provider in an embed.
+     *
+     * @param data the [EmbedProviderData] for the provider.
+     */
     public data class Provider(val data: EmbedProviderData, override val kord: Kord) : KordObject {
+        /** The name of the provider. */
         val name: String? get() = data.name.value
+        /** The URL for the provider. */
         val url: String? get() = data.url.value
     }
 
+    /**
+     * Represents an author in an embed.
+     *
+     * @param data the [EmbedAuthorData] for the author.
+     */
     public data class Author(val data: EmbedAuthorData, override val kord: Kord) : KordObject {
+        /** The name of the author. */
         val name: String? get() = data.name.value
+        /** The URL for the author. */
         val url: String? get() = data.url.value
+        /** The URL for the icon. */
         val iconUrl: String? get() = data.iconUrl.value
+        /** The proxy URL for the icon. */
         val proxyIconUrl: String? get() = data.proxyIconUrl.value
     }
 
+    /**
+     * Represents a field in an embed.
+     *
+     * @param data the [EmbedFieldData] for the field.
+     */
     public data class Field(val data: EmbedFieldData, override val kord: Kord) : KordObject {
+        /** The name of the field. */
         val name: String get() = data.name
+        /** The value of the field. */
         val value: String get() = data.value
+        /** Whether to inline the field or not. */
         val inline: Boolean? get() = data.inline.value
     }
 
diff --git a/core/src/commonMain/kotlin/entity/Emoji.kt b/core/src/commonMain/kotlin/entity/Emoji.kt
index fe8b21eeb95e..8a4fd1094f81 100644
--- a/core/src/commonMain/kotlin/entity/Emoji.kt
+++ b/core/src/commonMain/kotlin/entity/Emoji.kt
@@ -8,13 +8,13 @@ import dev.kord.core.behavior.MemberBehavior
 import dev.kord.core.behavior.RoleBehavior
 import dev.kord.core.behavior.UserBehavior
 import dev.kord.core.cache.data.EmojiData
+import dev.kord.core.hash
 import dev.kord.core.supplier.EntitySupplier
 import dev.kord.core.supplier.EntitySupplyStrategy
 import dev.kord.rest.builder.guild.EmojiModifyBuilder
 import kotlinx.coroutines.flow.Flow
 import kotlinx.coroutines.flow.emptyFlow
 import kotlinx.coroutines.flow.filter
-import dev.kord.core.hash
 import kotlin.contracts.InvocationKind
 import kotlin.contracts.contract
 
@@ -37,7 +37,7 @@ public sealed interface Emoji {
  * An instance of a
  * [standard emoji](https://discord.com/developers/docs/resources/emoji#emoji-object-standard-emoji-example).
  *
- * @property name The unicode representation of this emoji.
+ * @param name The unicode representation of this emoji.
  */
 public class StandardEmoji(override val name: String) : Emoji {
     /** The unicode representation of this emoji. */
@@ -50,6 +50,8 @@ public class StandardEmoji(override val name: String) : Emoji {
 /**
  * An instance of an [emoji](https://discord.com/developers/docs/resources/emoji#emoji-object) belonging to a specific
  * [Guild].
+ *
+ * @param data The [EmojiData] for the guild emoji
  */
 public class GuildEmoji(
     public val data: EmojiData,
diff --git a/core/src/commonMain/kotlin/entity/Guild.kt b/core/src/commonMain/kotlin/entity/Guild.kt
index 7716fb18527c..ab2d7bd098a9 100644
--- a/core/src/commonMain/kotlin/entity/Guild.kt
+++ b/core/src/commonMain/kotlin/entity/Guild.kt
@@ -33,6 +33,8 @@ import kotlin.time.Duration
 
 /**
  * An instance of a [Discord Guild](https://discord.com/developers/docs/resources/guild).
+ *
+ * @param data The [GuildData] for the guild
  */
 public class Guild(
     public val data: GuildData,
diff --git a/core/src/commonMain/kotlin/entity/GuildOnboarding.kt b/core/src/commonMain/kotlin/entity/GuildOnboarding.kt
index 6360d47d2008..859c88555ad1 100644
--- a/core/src/commonMain/kotlin/entity/GuildOnboarding.kt
+++ b/core/src/commonMain/kotlin/entity/GuildOnboarding.kt
@@ -20,6 +20,8 @@ import kotlinx.coroutines.flow.filter
 /**
  * Represents the [onboarding](https://support.discord.com/hc/en-us/articles/11074987197975-Community-Onboarding-FAQ)
  * flow for a [Guild].
+ *
+ * @param data The [DiscordGuildOnboarding] for the onbaording
  */
 public class GuildOnboarding(
     public val data: DiscordGuildOnboarding,
diff --git a/core/src/commonMain/kotlin/entity/GuildPreview.kt b/core/src/commonMain/kotlin/entity/GuildPreview.kt
index f06965e76b89..316425475cf5 100644
--- a/core/src/commonMain/kotlin/entity/GuildPreview.kt
+++ b/core/src/commonMain/kotlin/entity/GuildPreview.kt
@@ -5,6 +5,11 @@ import dev.kord.common.entity.Snowflake
 import dev.kord.core.Kord
 import dev.kord.core.cache.data.GuildPreviewData
 
+/**
+ * Represents a []guild preview object](https://discord.com/developers/docs/resources/guild#guild-preview-object)
+ *
+ * @param data The [GuildPreviewData] for the preview
+ */
 public class GuildPreview(
     public val data: GuildPreviewData,
     override val kord: Kord
@@ -13,54 +18,34 @@ public class GuildPreview(
     override val id: Snowflake
         get() = data.id
 
-    /**
-     * The name of the guild.
-     */
+    /** The name of the guild. */
     public val name: String get() = data.name
 
-    /**
-     * Icon hash.
-     */
+    /** Icon hash. */
     public val icon: String? get() = data.icon
 
-    /**
-     * Splash hash.
-     */
+    /** Splash hash. */
     public val splash: String? get() = data.splash
 
-    /**
-     * Discovery splash hash.
-     */
+    /** Discovery splash hash. */
     public val discoverySplash: String? get() = data.discoverySplash
 
-    /**
-     * Custom guild emojis.
-     */
+    /** Custom guild emojis. */
     public val emojis: Set<GuildEmoji> get() = data.emojis.map { GuildEmoji(it, kord) }.toSet()
 
-    /**
-     * Enabled guild features.
-     */
+    /** Enabled guild features. */
     public val features: Set<GuildFeature> get() = data.features.toSet()
 
-    /**
-     * Approximate number of members in this guild.
-     */
+    /** Approximate number of members in this guild. */
     public val approximateMemberCount: Int get() = data.approximateMemberCount
 
-    /**
-     * Approximate number of online members in this guild.
-     */
+    /** Approximate number of online members in this guild. */
     public val approximatePresenceCount: Int get() = data.approximatePresenceCount
 
-    /**
-     * The description for the guild.
-     */
+    /** The description for the guild. */
     public val description: String? get() = data.description
 
-    /**
-     * Custom guild stickers.
-     */
+    /** Custom guild stickers. */
     public val stickers: Set<Sticker> get() = data.stickers.map { GuildSticker(it, kord) }.toSet()
 
     override fun toString(): String {
diff --git a/core/src/commonMain/kotlin/entity/GuildScheduledEvent.kt b/core/src/commonMain/kotlin/entity/GuildScheduledEvent.kt
index d45080019273..62cb1a2bbd66 100644
--- a/core/src/commonMain/kotlin/entity/GuildScheduledEvent.kt
+++ b/core/src/commonMain/kotlin/entity/GuildScheduledEvent.kt
@@ -18,6 +18,8 @@ import kotlinx.datetime.Instant
  * An instance of a
  * [Guild scheduled event](https://discord.com/developers/docs/resources/guild-scheduled-event#guild-scheduled-event)
  * belonging to a specific guild.
+ *
+ * @param data The [GuildScheduledEventData] for the event
  */
 public class GuildScheduledEvent(
     public val data: GuildScheduledEventData,
diff --git a/core/src/commonMain/kotlin/entity/GuildWidget.kt b/core/src/commonMain/kotlin/entity/GuildWidget.kt
index 4e5658bcf539..eaaa6c25eb8a 100644
--- a/core/src/commonMain/kotlin/entity/GuildWidget.kt
+++ b/core/src/commonMain/kotlin/entity/GuildWidget.kt
@@ -1,6 +1,7 @@
 package dev.kord.core.entity
 
 import dev.kord.common.entity.Snowflake
+import dev.kord.common.exception.RequestException
 import dev.kord.core.Kord
 import dev.kord.core.KordObject
 import dev.kord.core.behavior.GuildBehavior
@@ -8,6 +9,7 @@ import dev.kord.core.behavior.channel.ChannelBehavior
 import dev.kord.core.cache.data.GuildWidgetData
 import dev.kord.core.entity.channel.Channel
 import dev.kord.core.entity.channel.TopGuildChannel
+import dev.kord.core.exception.EntityNotFoundException
 import dev.kord.core.supplier.EntitySupplier
 import dev.kord.core.supplier.EntitySupplyStrategy
 import dev.kord.core.supplier.getChannelOfOrNull
@@ -15,6 +17,7 @@ import dev.kord.rest.builder.guild.GuildWidgetModifyBuilder
 import kotlin.contracts.InvocationKind
 import kotlin.contracts.contract
 
+// TODO confirm this is actually a guild widget and not a guild widget settings object
 public class GuildWidget(
     public val data: GuildWidgetData,
     public val guildId: Snowflake,
@@ -22,23 +25,55 @@ public class GuildWidget(
     override val supplier: EntitySupplier = kord.defaultSupplier,
 ) : KordObject, Strategizable {
 
+    /** Whether the widget is enabled or not. */
     public val isEnabled: Boolean get() = data.enabled
 
+    /** The [GuildBehavior] for the widget. */
     public val guild: GuildBehavior get() = GuildBehavior(guildId, kord)
 
+    /** The ID of the channel the widget is for. */
     public val channelId: Snowflake? get() = data.channelId
 
+    /** The [ChannelBehavior] of the channel the widget is for. */
     public val channel: ChannelBehavior? get() = data.channelId?.let { ChannelBehavior(it, kord) }
 
+    /**
+     * Requests the [Guild] with the given [guildId].
+     *
+     * @throws RequestException if something went wrong while retrieving the guild.
+     * @throws EntityNotFoundException if the guild is null.
+     */
     public suspend fun getGuild(): Guild = supplier.getGuild(guildId)
 
+    /**
+     * Requests the [Guild] with the given [guildId], returns `null` when the guild isn't present.
+     *
+     * @throws RequestException if something went wrong while retrieving the guild.
+     */
     public suspend fun getGuildOrNull(): Guild? = supplier.getGuildOrNull(guildId)
 
+    /**
+     * Requests the [Channel] with the given [channelId] as type [TopGuildChannel], returns null if the
+     * channel isn't present or if the channel is not of type [TopGuildChannel].
+     *
+     * @throws RequestException if something went wrong while retrieving the channel.
+     */
     public suspend fun getChannelOrNull(): TopGuildChannel? = data.channelId?.let { supplier.getChannelOfOrNull(it) }
 
+    /**
+     * Requests the [Channel] with the given [channelId] as type [T], returns null if the
+     * channel isn't present or if the channel is not of type [T].
+     *
+     * @throws RequestException if something went wrong while retrieving the channel.
+     */
     public suspend inline fun <reified T : Channel> getChannelOfOrNull(): T? =
         data.channelId?.let { supplier.getChannelOfOrNull(it) }
 
+    /**
+     * Request to edit this [GuildWidget] and returns the edited widget.
+     *
+     * @throws RequestException if something went wrong during the request
+     */
     public suspend inline fun edit(builder: GuildWidgetModifyBuilder.() -> Unit): GuildWidget {
         contract { callsInPlace(builder, InvocationKind.EXACTLY_ONCE) }
         return GuildWidget(GuildWidgetData.from(kord.rest.guild.modifyGuildWidget(guildId, builder)), guildId, kord)
diff --git a/core/src/commonMain/kotlin/entity/Integration.kt b/core/src/commonMain/kotlin/entity/Integration.kt
index 3eef0926bf86..57aa6b970d5f 100644
--- a/core/src/commonMain/kotlin/entity/Integration.kt
+++ b/core/src/commonMain/kotlin/entity/Integration.kt
@@ -22,6 +22,8 @@ import kotlin.time.Duration
 
 /**
  * A [Discord integration](https://discord.com/developers/docs/resources/guild#get-guild-integrations).
+ *
+ * @param data The [IntegrationData] for the integration
  */
 public class Integration(
     public val data: IntegrationData,
@@ -51,7 +53,7 @@ public class Integration(
         get() = data.enabled
 
     /**
-     * Whether this integrations is syncing.
+     * Whether this integration is syncing.
      */
     public val isSyncing: Boolean?
         get() = data.syncing.value
diff --git a/core/src/commonMain/kotlin/entity/Invite.kt b/core/src/commonMain/kotlin/entity/Invite.kt
index 332bc10d387b..378831f02de8 100644
--- a/core/src/commonMain/kotlin/entity/Invite.kt
+++ b/core/src/commonMain/kotlin/entity/Invite.kt
@@ -19,6 +19,8 @@ import kotlin.time.Duration
 
 /**
  * An instance of a [Discord Invite](https://discord.com/developers/docs/resources/invite).
+ *
+ * @param data The data for the invite
  */
 public open class Invite(
     public open val data: BaseInviteData,
@@ -140,6 +142,9 @@ public open class Invite(
 /**
  * An instance of a [Discord Invite](https://discord.com/developers/docs/resources/invite) with
  * [extra information](https://discord.com/developers/docs/resources/invite#invite-metadata-object).
+ *
+ * @param kord The Kord instance that created this object
+ * @param supplier THe supplier used to request entities
  */
 public class InviteWithMetadata(
     override val data: InviteWithMetadataData,
diff --git a/core/src/commonMain/kotlin/entity/Member.kt b/core/src/commonMain/kotlin/entity/Member.kt
index a37683931c27..858fc2d2d781 100644
--- a/core/src/commonMain/kotlin/entity/Member.kt
+++ b/core/src/commonMain/kotlin/entity/Member.kt
@@ -12,14 +12,19 @@ import dev.kord.core.behavior.UserBehavior
 import dev.kord.core.cache.data.MemberData
 import dev.kord.core.cache.data.UserData
 import dev.kord.core.entity.interaction.GuildInteraction
+import dev.kord.core.hash
 import dev.kord.core.supplier.EntitySupplier
 import dev.kord.core.supplier.EntitySupplyStrategy
 import kotlinx.coroutines.flow.*
 import kotlinx.datetime.Instant
-import dev.kord.core.hash
 
 /**
  * An instance of a [Discord Member](https://discord.com/developers/docs/resources/guild#guild-member-object).
+ *
+ * @param memberData The [MemberData] for the Member
+ * @param userData The [UserData] of the member
+ * @param kord The kord instance that created this object
+ * @param supplier The supplier used to request entities
  */
 public class Member(
     public val memberData: MemberData,
@@ -71,7 +76,7 @@ public class Member(
      * The [roles][Role] that apply to this user.
      *
      * This request uses state [data] to resolve the entities belonging to the flow,
-     * as such it can't guarantee an up to date representation if the [data] is outdated.
+     * as such it can't guarantee an up-to-date representation if the [data] is outdated.
      *
      * The returned flow is lazily executed, any [RequestException] will be thrown on
      * [terminal operators](https://kotlinlang.org/docs/reference/coroutines/flow.html#terminal-flow-operators) instead.
diff --git a/core/src/commonMain/kotlin/entity/Message.kt b/core/src/commonMain/kotlin/entity/Message.kt
index 3669a1488788..acae750cc90f 100644
--- a/core/src/commonMain/kotlin/entity/Message.kt
+++ b/core/src/commonMain/kotlin/entity/Message.kt
@@ -23,16 +23,18 @@ import dev.kord.core.entity.component.ActionRowComponent
 import dev.kord.core.entity.interaction.ActionInteraction
 import dev.kord.core.entity.interaction.followup.FollowupMessage
 import dev.kord.core.exception.EntityNotFoundException
+import dev.kord.core.hash
 import dev.kord.core.supplier.EntitySupplier
 import dev.kord.core.supplier.EntitySupplyStrategy
 import dev.kord.core.supplier.getChannelOf
 import dev.kord.core.supplier.getChannelOfOrNull
 import kotlinx.coroutines.flow.*
 import kotlinx.datetime.Instant
-import dev.kord.core.hash
 
 /**
  * An instance of a [Discord Message][https://discord.com/developers/docs/resources/channel#message-object].
+ *
+ * @param data The [MessageData] for the message
  */
 public class Message(
     public val data: MessageData,
@@ -44,6 +46,8 @@ public class Message(
      * An instance of [MessageInteraction](https://discord.com/developers/docs/interactions/receiving-and-responding#message-interaction-object)
      *
      * This is sent on the [Message] object when the message is a response to an [ActionInteraction].
+     *
+     * @param data The [MessageInteractionData] for the interaction
      */
     public class Interaction(
         public val data: MessageInteractionData,
@@ -139,7 +143,7 @@ public class Message(
     /**
      * The ids of [Channels][Channel] specifically mentioned in this message.
      *
-     * This collection can only contain values on crossposted messages, channels
+     * This collection can only contain values on cross-posted messages, channels
      * mentioned inside the same guild will not be present.
      */
     public val mentionedChannelIds: Set<Snowflake> get() = data.mentionedChannels.orEmpty().map { it }.toSet()
@@ -147,7 +151,7 @@ public class Message(
     /**
      * The [Channels][ChannelBehavior] specifically mentioned in this message.
      *
-     * This collection can only contain values on crossposted messages, channels
+     * This collection can only contain values on cross-posted messages, channels
      * mentioned inside the same guild will not be present.
      */
     public val mentionedChannelBehaviors: Set<ChannelBehavior>
@@ -173,7 +177,7 @@ public class Message(
     public val referencedMessage: Message? get() = data.referencedMessage.value?.let { Message(it, kord) }
 
     /**
-     * reference data sent with crossposted messages and replies.
+     * reference data sent with cross-posted messages and replies.
      *
      * This field is only returned for messages with [MessageType.Reply].
      * If the message is a reply but the [referencedMessage] field is not present,
@@ -186,11 +190,11 @@ public class Message(
     /**
      * The [Channels][Channel] specifically mentioned in this message.
      *
-     * This property will only emit values on crossposted messages, channels
+     * This property will only emit values on cross-posted messages, channels
      * mentioned inside the same guild will not be present.
      *
      * This request uses state [data] to resolve the entities belonging to the flow,
-     * as such it can't guarantee an up to date representation if the [data] is outdated.
+     * as such it can't guarantee an up-to-date representation if the [data] is outdated.
      *
      * The returned flow is lazily executed, any [RequestException] will be thrown on
      * [terminal operators](https://kotlinlang.org/docs/reference/coroutines/flow.html#terminal-flow-operators) instead.
diff --git a/core/src/commonMain/kotlin/entity/MessageReference.kt b/core/src/commonMain/kotlin/entity/MessageReference.kt
index 538dd500825c..479830f5c4c1 100644
--- a/core/src/commonMain/kotlin/entity/MessageReference.kt
+++ b/core/src/commonMain/kotlin/entity/MessageReference.kt
@@ -7,12 +7,20 @@ import dev.kord.core.behavior.MessageBehavior
 import dev.kord.core.behavior.channel.MessageChannelBehavior
 import dev.kord.core.cache.data.MessageReferenceData
 
+/**
+ * Represents a [message reference object](https://discord.com/developers/docs/resources/channel#message-reference-object).
+ *
+ * @param data The [MessageReferenceData] for the reference
+ */
 public class MessageReference(public val data: MessageReferenceData, override val kord: Kord) : KordObject {
 
+    /** The [GuildBehavior] of the guild the referenced message is in. */
     public val guild: GuildBehavior? get() = data.guildId.value?.let { GuildBehavior(it, kord) }
 
+    /** The [MessageChannelBehavior] of the channel the referenced message is in. */
     public val channel: MessageChannelBehavior get() = MessageChannelBehavior(data.channelId.value!!, kord)
 
+    /** The [MessageBehavior] of the referenced message. */
     public val message: MessageBehavior? get() = data.id.value?.let { MessageBehavior(channel.id, it, kord) }
 
 
diff --git a/core/src/commonMain/kotlin/entity/PartialGuild.kt b/core/src/commonMain/kotlin/entity/PartialGuild.kt
index 616eedbadb4c..339a75604e20 100644
--- a/core/src/commonMain/kotlin/entity/PartialGuild.kt
+++ b/core/src/commonMain/kotlin/entity/PartialGuild.kt
@@ -15,6 +15,11 @@ import dev.kord.core.hash
 import dev.kord.core.supplier.EntitySupplier
 import dev.kord.core.supplier.EntitySupplyStrategy
 
+/**
+ * Represents a [Partial guild object](https://discord.com/developers/docs/resources/guild#unavailable-guild-object).
+ *
+ * @param data The [PartialGuildData] for the guild
+ */
 public class PartialGuild(
     public val data: PartialGuildData,
     override val kord: Kord,
@@ -37,7 +42,7 @@ public class PartialGuild(
     public val icon: Asset? get() = iconHash?.let { Asset.guildIcon(id, it, kord) }
 
     /**
-     * wither who created the invite is the owner or not.
+     * Whether who created the invite is the owner or not.
      */
 
     public val owner: Boolean? get() = data.owner.value
@@ -83,6 +88,9 @@ public class PartialGuild(
      */
     public val verificationLevel: VerificationLevel? get() = data.verificationLevel.value
 
+    /**
+     * The hash for the discovery splash.
+     */
     public val splashHash: String? get() = data.splash.value
 
     public val splash: Asset? get() = splashHash?.let { Asset.guildSplash(id, it, kord) }
diff --git a/core/src/commonMain/kotlin/entity/PermissionOverwrite.kt b/core/src/commonMain/kotlin/entity/PermissionOverwrite.kt
index da222e8db186..588b11f1356a 100644
--- a/core/src/commonMain/kotlin/entity/PermissionOverwrite.kt
+++ b/core/src/commonMain/kotlin/entity/PermissionOverwrite.kt
@@ -6,12 +6,21 @@ import dev.kord.common.entity.Snowflake
 import dev.kord.core.cache.data.PermissionOverwriteData
 import dev.kord.rest.json.request.ChannelPermissionEditRequest
 
+/**
+ * Represents a permission overwrite.
+ *
+ * @param data The data for this overwrite
+ */
 public open class PermissionOverwrite(
     public val data: PermissionOverwriteData,
 ) {
+    /** The allowed [Permissions] in this overwrite. */
     public val allowed: Permissions get() = data.allowed
+    /** The denied [Permissions] in this overwrite. */
     public val denied: Permissions get() = data.denied
+    /** The target channel id for this overwrite. */
     public val target: Snowflake get() = data.id
+    /** The [type][OverwriteType] for this overwrite. */
     public val type: OverwriteType get() = data.type
 
     internal fun asRequest() = ChannelPermissionEditRequest(allowed, denied, type)
diff --git a/core/src/commonMain/kotlin/entity/PermissionOverwriteEntity.kt b/core/src/commonMain/kotlin/entity/PermissionOverwriteEntity.kt
index 2f8f92c902cd..68d2a60bc242 100644
--- a/core/src/commonMain/kotlin/entity/PermissionOverwriteEntity.kt
+++ b/core/src/commonMain/kotlin/entity/PermissionOverwriteEntity.kt
@@ -15,6 +15,13 @@ import dev.kord.core.supplier.getChannelOf
 import dev.kord.core.supplier.getChannelOfOrNull
 import dev.kord.rest.request.RestRequestException
 
+/**
+ * Represents a permission overwrite as an entity.
+ *
+ * @param guildId The ID of the guild this overwrite is for
+ * @param channelId The ID of the channel this overwrite is for.
+ * @param data The data for this overwrite
+ */
 public class PermissionOverwriteEntity(
     public val guildId: Snowflake,
     public val channelId: Snowflake,
@@ -23,8 +30,10 @@ public class PermissionOverwriteEntity(
     override val supplier: EntitySupplier = kord.defaultSupplier
 ) : PermissionOverwrite(data), KordObject, Strategizable {
 
+    /** The [GuildBehavior] for the entity. */
     public val guild: GuildBehavior get() = GuildBehavior(guildId, kord)
 
+    /** The [TopGuildChannelBehavior] for the overwrite entity. */
     public val channel: TopGuildChannelBehavior get() = TopGuildChannelBehavior(guildId, channelId, kord)
 
     /**
@@ -44,7 +53,7 @@ public class PermissionOverwriteEntity(
     public suspend fun getChannelOrNull(): TopGuildChannel? = supplier.getChannelOfOrNull(channelId)
 
     /**
-     * Requests to get the the guild of this overwrite.
+     * Requests to get the guild of this overwrite.
      *
      * @throws [RequestException] if anything went wrong during the request.
      * @throws [EntityNotFoundException] if the [Guild] wasn't present.
diff --git a/core/src/commonMain/kotlin/entity/Presence.kt b/core/src/commonMain/kotlin/entity/Presence.kt
index afcc1e90ed58..7b0abe472962 100644
--- a/core/src/commonMain/kotlin/entity/Presence.kt
+++ b/core/src/commonMain/kotlin/entity/Presence.kt
@@ -11,20 +11,30 @@ import dev.kord.core.exception.EntityNotFoundException
 import dev.kord.core.supplier.EntitySupplier
 import dev.kord.core.supplier.EntitySupplyStrategy
 
+/**
+ * Represents a user's current state on a guild.
+ *
+ * @param data The [PresenceData] for the user
+ */
 public class Presence(
     public val data: PresenceData,
     override val kord: Kord,
     override val supplier: EntitySupplier = kord.defaultSupplier
 ) : KordObject, Strategizable {
 
+    /** A [List] of the users current [Activity] */
     public val activities: List<Activity> get() = data.activities.map { Activity(it) }
 
+    /** The user's platform dependent [ClientStatus] */
     public val clientStatus: ClientStatus get() = ClientStatus(data.clientStatus)
 
+    /** The ID of the guild. */
     public val guildId: Snowflake get() = data.guildId
 
+    /** The users [PresenceStatus]. */
     public val status: PresenceStatus get() = data.status
 
+    /** The ID of the user whose presence is updated. */
     public val userId: Snowflake get() = data.userId
 
     /**
@@ -55,18 +65,32 @@ public class Presence(
 
 }
 
+/**
+ * A representation of the available client statuses
+ */
 public class ClientStatus(public val data: ClientStatusData) {
+    /** Represents a desktop client. */
     public val desktop: Client.Desktop? get() = data.desktop.value?.let { Client.Desktop(it) }
+    /** Represents a mobile client. */
     public val mobile: Client.Mobile? get() = data.mobile.value?.let { Client.Mobile(it) }
+    /** Represents a web client. */
     public val web: Client.Web? get() = data.web.value?.let { Client.Web(it) }
 
     override fun toString(): String {
         return "ClientStatus(data=$data)"
     }
 
+    /**
+     * The available client status.
+     *
+     * @param status The [PresenceStatus] of the client
+     */
     public sealed class Client(public val status: PresenceStatus) {
+        /** A Desktop Client. */
         public class Desktop(status: PresenceStatus) : Client(status)
+        /** A Mobile Client. */
         public class Mobile(status: PresenceStatus) : Client(status)
+        /** A Web Client. */
         public class Web(status: PresenceStatus) : Client(status)
     }
 }
diff --git a/core/src/commonMain/kotlin/entity/Reaction.kt b/core/src/commonMain/kotlin/entity/Reaction.kt
index 9327c12871c2..0c6a191b3847 100644
--- a/core/src/commonMain/kotlin/entity/Reaction.kt
+++ b/core/src/commonMain/kotlin/entity/Reaction.kt
@@ -7,9 +7,14 @@ import dev.kord.core.cache.data.ReactionData
 
 /**
  * An instance of a [Discord Reaction](https://discord.com/developers/docs/resources/channel#reaction-object).
+ *
+ * @param data The [ReactionData] for the reaction.
  */
 public class Reaction(public val data: ReactionData, override val kord: Kord) : KordObject {
 
+    /**
+     * The ID of the reaction emoji.
+     */
     public val id: Snowflake? get() = data.emojiId
 
     /**
diff --git a/core/src/commonMain/kotlin/entity/ReactionEmoji.kt b/core/src/commonMain/kotlin/entity/ReactionEmoji.kt
index a44317e439d2..89d06d895265 100644
--- a/core/src/commonMain/kotlin/entity/ReactionEmoji.kt
+++ b/core/src/commonMain/kotlin/entity/ReactionEmoji.kt
@@ -3,6 +3,9 @@ package dev.kord.core.entity
 import dev.kord.common.entity.Snowflake
 import dev.kord.core.cache.data.RemovedReactionData
 
+/**
+ * An instance of an emoji that is used for reactions.
+ */
 public sealed class ReactionEmoji {
     /**
      * Format used in HTTP queries.
@@ -14,9 +17,15 @@ public sealed class ReactionEmoji {
      */
     public abstract val name: String
 
-
+    /** The mention string for the Reaction Emoji. */
     public abstract val mention: String
 
+    /**
+     * A custom representation of a reaction emoji
+     *
+     * @param id The ID of the reaction emoji
+     * @param isAnimated Whether the emoji is animated or not
+     */
     public data class Custom(val id: Snowflake, override val name: String, val isAnimated: Boolean) : ReactionEmoji() {
 
         override val urlFormat: String
@@ -29,6 +38,9 @@ public sealed class ReactionEmoji {
         override fun toString(): String = "Custom(id=$id, name=$name, isAnimated=$isAnimated)"
     }
 
+    /**
+     * A unicode representation of a reaction emoji.
+     */
     public data class Unicode(override val name: String) : ReactionEmoji() {
         override val urlFormat: String get() = name
         override val mention: String get() = name
diff --git a/core/src/commonMain/kotlin/entity/Region.kt b/core/src/commonMain/kotlin/entity/Region.kt
index e6ff8acd7472..a562e13d92be 100644
--- a/core/src/commonMain/kotlin/entity/Region.kt
+++ b/core/src/commonMain/kotlin/entity/Region.kt
@@ -5,16 +5,26 @@ import dev.kord.core.KordObject
 import dev.kord.core.cache.data.RegionData
 import dev.kord.core.hash
 
+/**
+ * Represents a Voice Region for a guild.
+ *
+ * @param data The [RegionData] for the guild.
+ */
 public class Region(public val data: RegionData, override val kord: Kord) : KordObject {
+    /** The unique ID for the region. */
     public val id: String
         get() = data.id
 
+    /** Whether this is a custom voice region (used for events/etc) */
     public val isCustom: Boolean get() = data.custom
 
+    /** Whether this is a deprecated voice region (avoid switching to these) */
     public val isDeprecated: Boolean get() = data.deprecated
 
+    /** The name of the region. */
     public val name: String get() = data.name
 
+    /** True for a single server that is closest to the current user's client. */
     public val isOptimal: Boolean get() = data.optimal
 
     override fun hashCode(): Int = hash(id)
diff --git a/core/src/commonMain/kotlin/entity/Role.kt b/core/src/commonMain/kotlin/entity/Role.kt
index 7ba49e4d5133..cfa7f8d04c18 100644
--- a/core/src/commonMain/kotlin/entity/Role.kt
+++ b/core/src/commonMain/kotlin/entity/Role.kt
@@ -12,6 +12,11 @@ import dev.kord.core.supplier.EntitySupplier
 import dev.kord.core.supplier.EntitySupplyStrategy
 import dev.kord.core.hash
 
+/**
+ * An instance of a [Discord role](https://discord.com/developers/docs/topics/permissions#role-object)
+ *
+ * @param data The [RoleData] for the role
+ */
 public data class Role(
     val data: RoleData,
     override val kord: Kord,
@@ -24,24 +29,33 @@ public data class Role(
     override val guildId: Snowflake
         get() = data.guildId
 
+    /** The colour of the role, as a [Color] object. */
     public val color: Color get() = Color(data.color)
 
+    /** If this role is pinned in the user listing. */
     public val hoisted: Boolean get() = data.hoisted
 
     val iconHash: String? get() = data.icon.value
 
+    /** The icon of the role as an [Asset] object. */
     val icon: Asset? get() = iconHash?.let { Asset.roleIcon(id, it, kord) }
 
+    /** The unicode of the role emoji. */
     val unicodeEmoji: String? = data.unicodeEmoji.value
 
+    /** Whether an integration manages this role or not. */
     public val managed: Boolean get() = data.managed
 
+    /** Whether this role is mentionable or not. */
     public val mentionable: Boolean get() = data.mentionable
 
+    /** The name of this role. */
     public val name: String get() = data.name
 
+    /** The [Permissions] set for this role. */
     public val permissions: Permissions get() = data.permissions
 
+    /** The position of this role in the list. */
     public val rawPosition: Int get() = data.position
 
     override suspend fun asRole(): Role = this
diff --git a/core/src/commonMain/kotlin/entity/RoleTags.kt b/core/src/commonMain/kotlin/entity/RoleTags.kt
index 42f88fd2465d..98482f632df1 100644
--- a/core/src/commonMain/kotlin/entity/RoleTags.kt
+++ b/core/src/commonMain/kotlin/entity/RoleTags.kt
@@ -1,16 +1,22 @@
 package dev.kord.core.entity
 
 import dev.kord.common.entity.Snowflake
+import dev.kord.common.exception.RequestException
 import dev.kord.core.Kord
 import dev.kord.core.KordObject
 import dev.kord.core.behavior.GuildBehavior
 import dev.kord.core.cache.data.IntegrationData
 import dev.kord.core.cache.data.RoleTagsData
-import dev.kord.core.supplier.EntitySupplier
-import dev.kord.common.exception.RequestException
 import dev.kord.core.exception.EntityNotFoundException
+import dev.kord.core.supplier.EntitySupplier
 import dev.kord.core.supplier.EntitySupplyStrategy
 
+/**
+ * The tags for a role.
+ *
+ * @param data The [RoleTagsData] for the role tags
+ * @param guildId The ID of the guild the roles are in
+ */
 public class RoleTags(
     public val data: RoleTagsData,
     public val guildId: Snowflake,
diff --git a/core/src/commonMain/kotlin/entity/StageInstance.kt b/core/src/commonMain/kotlin/entity/StageInstance.kt
index b53dfb8f4f63..4e7f7a51f928 100644
--- a/core/src/commonMain/kotlin/entity/StageInstance.kt
+++ b/core/src/commonMain/kotlin/entity/StageInstance.kt
@@ -9,6 +9,11 @@ import dev.kord.core.entity.channel.StageChannel
 import dev.kord.core.supplier.EntitySupplier
 import dev.kord.core.supplier.EntitySupplyStrategy
 
+/**
+ * Holds information about a live stage
+ *
+ * @param data The [StageInstanceData] for the live stage
+ */
 public class StageInstance(
     public val data: StageInstanceData,
     override val kord: Kord,
diff --git a/core/src/commonMain/kotlin/entity/Sticker.kt b/core/src/commonMain/kotlin/entity/Sticker.kt
index 8333346a3d98..5c0bd40b5d1a 100644
--- a/core/src/commonMain/kotlin/entity/Sticker.kt
+++ b/core/src/commonMain/kotlin/entity/Sticker.kt
@@ -4,16 +4,20 @@ import dev.kord.common.entity.MessageStickerType
 import dev.kord.common.entity.Snowflake
 import dev.kord.common.entity.optional.unwrap
 import dev.kord.common.entity.optional.value
+import dev.kord.common.exception.RequestException
 import dev.kord.core.Kord
 import dev.kord.core.behavior.StickerBehavior
 import dev.kord.core.cache.data.StickerData
 import dev.kord.core.cache.data.StickerItemData
 import dev.kord.core.cache.data.StickerPackData
+import dev.kord.core.exception.EntityNotFoundException
 import dev.kord.core.supplier.EntitySupplier
 import dev.kord.core.supplier.EntitySupplyStrategy
 
 /**
  * A sticker image that can be used in messages.
+ *
+ * @param data The [StickerData] for the sticker
  */
 public open class Sticker(public val data: StickerData, override val kord: Kord)  : KordEntity {
 
@@ -55,17 +59,32 @@ public open class Sticker(public val data: StickerData, override val kord: Kord)
 
     public val asset: Asset get() = Asset.sticker(id, formatType, kord)
 
+    /**
+     * Whether this guild sticker can be used. May be false due to a loss of boosts.
+     */
     public val available: Boolean
         get() = data.available.discordBoolean
 
+    /**
+     * The standard sticker's sort order within its pack
+     */
     public val sortValue: Int?
         get() = data.sortValue.value
 
+    /**
+     * The [User] that uploaded the guild sticker.
+     */
     public val user: User?
         get() = data.user.unwrap { User(it, kord) }
 
 }
 
+/**
+ * An instance of a [Sticker] specific to a give guild.
+ *
+ * @param data The [StickerData] for the guild sticker
+ * @param kord The [Kord] instance that created this object
+ */
 public class GuildSticker(data: StickerData, kord: Kord, override val supplier: EntitySupplier = kord.defaultSupplier) : Sticker(data, kord), StickerBehavior {
     override val guildId: Snowflake
         get() = data.guildId.value!!
@@ -81,8 +100,11 @@ public class GuildSticker(data: StickerData, kord: Kord, override val supplier:
 
 }
 
-
-
+/**
+ * An object for an Item of a sticker.
+ *
+ * @param data The [StickerItemData] for the STicker Item
+ */
 public class StickerItem(
     public val data: StickerItemData,
     override val kord: Kord,
@@ -92,18 +114,35 @@ public class StickerItem(
     public override val id: Snowflake
         get() = data.id
 
+    /** The name of the sticker */
     public val name: String
         get() = data.name
 
+    /**
+     * The [MessageStickerType] for the sticker
+     */
     public val formatType: MessageStickerType
         get() = data.formatType
 
     public val asset: Asset get() = Asset.sticker(id, formatType, kord)
 
+    /**
+     * Gets a [Sticker] from a given [id].
+     * returns `null` if the sticker cannot be found
+     *
+     * @return The [Sticker] or `null` if the sticker was not found
+     * @throws RequestException if something went wrong during the request
+     */
     public suspend fun getStickerOrNull(): Sticker? =
         supplier.getStickerOrNull(id)
 
-
+    /**
+     * Gets a [Sticker] from a given [id].
+     *
+     * @return The [Sticker] or throws an [EntityNotFoundException] if the sticker was not found
+     * @throws RequestException if something went wrong during the request
+     * @throws EntityNotFoundException if the sticker was null
+     */
     public suspend fun getSticker(): Sticker =
         supplier.getSticker(id)
 
@@ -112,19 +151,29 @@ public class StickerItem(
         StickerItem(data, kord, strategy.supply(kord))
 }
 
+/**
+ * Represents a pack of standard stickers
+ *
+ * @param data The [StickerPackData] for the pack.
+ */
 public class StickerPack(public val data: StickerPackData, override val kord: Kord) : KordEntity {
 
     public override val id: Snowflake
         get() = data.id
 
+    /** The name of the sticker pack */
     public val name: String get() = data.name
 
+    /** The ID of the packs SKU */
     public val skuId: Snowflake get() = data.skuId
 
+    /** ID of a sticker in the pack which is shown as the pack's icon */
     public val coverStickerId: Snowflake? get() = data.coverStickerId.value
 
+    /** The sticker pack description. */
     public val description: String get() = data.description
 
+    /** A [List] of the [Sticker]s in the pack. */
     public val stickers: List<Sticker> get() = data.stickers.map { Sticker(it, kord) }
 
     public val bannerId: Snowflake get() = data.bannerAssetId
diff --git a/core/src/commonMain/kotlin/entity/Team.kt b/core/src/commonMain/kotlin/entity/Team.kt
index 894e9ae9c345..72c8dc3e61b7 100644
--- a/core/src/commonMain/kotlin/entity/Team.kt
+++ b/core/src/commonMain/kotlin/entity/Team.kt
@@ -13,6 +13,8 @@ import dev.kord.core.supplier.EntitySupplyStrategy
 
 /**
  * A Discord [developer team](https://discord.com/developers/docs/topics/teams) which can own applications.
+ *
+ * @param data The [TeamData] for the team
  */
 public class Team(
     public val data: TeamData,
@@ -69,6 +71,9 @@ public class Team(
 
 /**
  * A member of a Discord developer team.
+ *
+ * @param data The [TeamMemberData] for the team member
+ * @param kord The [Kord] instance that created this object
  */
 public class TeamMember(public val data: TeamMemberData, public val kord: Kord) {
     /**
diff --git a/core/src/commonMain/kotlin/entity/Template.kt b/core/src/commonMain/kotlin/entity/Template.kt
index 2dc4df10fe39..65f5054b10bf 100644
--- a/core/src/commonMain/kotlin/entity/Template.kt
+++ b/core/src/commonMain/kotlin/entity/Template.kt
@@ -7,26 +7,40 @@ import dev.kord.core.behavior.TemplateBehavior
 import dev.kord.core.cache.data.TemplateData
 import kotlinx.datetime.Instant
 
+/**
+ * Represents a code that when used, creates a guild based on a snapshot of an existing guild.
+ *
+ * @param data The [TemplateData] for the tempalte
+ */
 public class Template(public val data: TemplateData, override val kord: Kord) : KordObject, TemplateBehavior {
     override val code: String get() = data.code
 
+    /** The template name */
     public val name: String get() = data.name
 
+    /** The template description */
     public val description: String? get() = data.description
 
+    /** The number of uses this template has. */
     public val usageCount: Int get() = data.usageCount
 
+    /** The ID of the user that created the template. */
     public val creatorId: Snowflake get() = data.creatorId
 
+    /** The [User] object of the user that created the template. */
     public val creator: User get() = User(data.creator, kord)
 
+    /** The [Instant] the template was created. */
     public val createdAt: Instant get() = data.createdAt
 
+    /** The [Instant] the template was last updated. */
     public val updatedAt: Instant get() = data.updatedAt
 
     override val guildId: Snowflake get() = data.sourceGuildId
 
+    /** A [PartialGuild] object for the template. */
     public val partialGuild: PartialGuild get() = PartialGuild(data.serializedSourceGuild, kord)
 
+    /** Whether the template has unsynced changes. */
     public val dirty: Boolean? = data.isDirty
 }
diff --git a/core/src/commonMain/kotlin/entity/User.kt b/core/src/commonMain/kotlin/entity/User.kt
index bbcc37af6f8b..74703a01397d 100644
--- a/core/src/commonMain/kotlin/entity/User.kt
+++ b/core/src/commonMain/kotlin/entity/User.kt
@@ -28,10 +28,13 @@ public val User.effectiveName: String get() = globalName ?: username
 
 /**
  * An instance of a [Discord User](https://discord.com/developers/docs/resources/user#user-object).
+ *
+ * @param data The [UserData] for the discord user
  */
 public open class User(
     public val data: UserData,
-    override val kord: Kord, override val supplier: EntitySupplier = kord.defaultSupplier,
+    override val kord: Kord,
+    override val supplier: EntitySupplier = kord.defaultSupplier,
 ) : UserBehavior {
 
     override val id: Snowflake
@@ -41,12 +44,15 @@ public open class User(
      * Returns true if the user is the same as the bot.
      */
     public val isSelf: Boolean get() = id == kord.selfId
-   
+
     public val avatarHash: String? get() = data.avatar
 
     /** The avatar of this user as an [Asset]. */
     public val avatar: Asset? get() = avatarHash?.let { Asset.userAvatar(data.id, it, kord) }
 
+    /**
+     * The default avatar for the user as [Asset] object.
+     */
     public val defaultAvatar: Asset
         get() =
             if (migratedToNewUsernameSystem) Asset.defaultUserAvatar(userId = id, kord)
@@ -105,6 +111,9 @@ public open class User(
      */
     public val isBot: Boolean get() = data.bot.discordBoolean
 
+    /**
+     * The user's banner color as a [Color] object
+     */
     public val accentColor: Color? get() = data.accentColor?.let { Color(it) }
 
     public val bannerHash: String? get() = data.banner
diff --git a/core/src/commonMain/kotlin/entity/VoiceState.kt b/core/src/commonMain/kotlin/entity/VoiceState.kt
index 22003beea14b..ec900b9e62a6 100644
--- a/core/src/commonMain/kotlin/entity/VoiceState.kt
+++ b/core/src/commonMain/kotlin/entity/VoiceState.kt
@@ -13,6 +13,11 @@ import dev.kord.core.supplier.EntitySupplyStrategy
 import dev.kord.core.supplier.getChannelOfOrNull
 import kotlinx.datetime.Instant
 
+/**
+ * Used to represent a user's voice connection status.
+ *
+ * @param data The [VoiceStateData] for the state
+ */
 public class VoiceState(
     public val data: VoiceStateData,
     override val kord: Kord,
diff --git a/core/src/commonMain/kotlin/entity/Webhook.kt b/core/src/commonMain/kotlin/entity/Webhook.kt
index 2874331d5050..1a51775cd621 100644
--- a/core/src/commonMain/kotlin/entity/Webhook.kt
+++ b/core/src/commonMain/kotlin/entity/Webhook.kt
@@ -17,6 +17,11 @@ import dev.kord.core.supplier.getChannelOf
 import dev.kord.core.supplier.getChannelOfOrNull
 import dev.kord.core.hash
 
+/**
+ * Low-effort way to post messages to channels in Discord. They do not require a bot user or authentication to use.
+ *
+ * @param data The [WebhookData] for the webhook.
+ */
 public data class Webhook(
     val data: WebhookData,
     override val kord: Kord,
@@ -25,20 +30,44 @@ public data class Webhook(
 
     override val id: Snowflake get() = data.id
 
+    /**
+     * The [WebhookType] for this webhook.
+     */
     val type: WebhookType get() = data.type
 
+    /**
+     * The ID of the webhook creator
+     */
     val creatorId: Snowflake? get() = data.userId.value
 
+    /**
+     * The ID of the channel the webhook was created in.
+     */
     val channelId: Snowflake get() = data.channelId
 
+    /**
+     * The ID of the guild the webhook was created in.
+     */
     val guildId: Snowflake? get() = data.guildId.value
 
+    /**
+     * The default name of the webhook
+     */
     val name: String? get() = data.name
 
+    /**
+     * The secure token of the webhook. (returned for incoming webhooks)
+     */
     val token: String? get() = data.token.value
 
+    /**
+     * The [MessageChannelBehavior] for the channel the webhook was created in.
+     */
     val channel: MessageChannelBehavior get() = MessageChannelBehavior(channelId, kord)
 
+    /**
+     * The [GuildBehavior] for the guild the webhook was creaeted in.
+     */
     val guild: GuildBehavior? get() = guildId?.let { GuildBehavior(it, kord) }
 
     /**
diff --git a/core/src/commonMain/kotlin/entity/WelcomeScreen.kt b/core/src/commonMain/kotlin/entity/WelcomeScreen.kt
index 78decbd2dd04..0387ac8e1ed2 100644
--- a/core/src/commonMain/kotlin/entity/WelcomeScreen.kt
+++ b/core/src/commonMain/kotlin/entity/WelcomeScreen.kt
@@ -8,13 +8,18 @@ import dev.kord.core.entity.channel.WelcomeScreenChannel
 /**
  * Shown to new members in community guild, returned when in the invite object.
  *
- * @property description the server description shown in the welcome screen.
- * @property welcomeScreenChannels  The channels shown in the welcome screen.
+ * @param data The [WelcomeScreenData] for the Welcome screen
  */
 public class WelcomeScreen(public val data: WelcomeScreenData, override val kord: Kord) : KordObject {
 
+    /**
+     * The server description shown in the welcome screen.
+     */
     public val description: String? get() = data.description
 
+    /**
+     * The channels shown in the welcome screen.
+     */
     public val welcomeScreenChannels: List<WelcomeScreenChannel>
         get() = data.welcomeChannels.map { WelcomeScreenChannel(it, kord) }
 
diff --git a/core/src/commonMain/kotlin/event/automoderation/AutoModerationActionExecutionEvent.kt b/core/src/commonMain/kotlin/event/automoderation/AutoModerationActionExecutionEvent.kt
index d8f5eb909890..984444f722d3 100644
--- a/core/src/commonMain/kotlin/event/automoderation/AutoModerationActionExecutionEvent.kt
+++ b/core/src/commonMain/kotlin/event/automoderation/AutoModerationActionExecutionEvent.kt
@@ -25,6 +25,8 @@ import dev.kord.gateway.Intent.MessageContent
  * executed (e.g. when a message is [blocked][BlockMessageAutoModerationAction]).
  *
  * This event is only sent to bot users which have the [ManageGuild] permission.
+ *
+ * See [Auto moderation action execution event](https://discord.com/developers/docs/topics/gateway-events#auto-moderation-action-execution)
  */
 public class AutoModerationActionExecutionEvent(
     public val data: AutoModerationActionExecutionEventData,
diff --git a/core/src/commonMain/kotlin/event/automoderation/AutoModerationRuleConfigurationEvent.kt b/core/src/commonMain/kotlin/event/automoderation/AutoModerationRuleConfigurationEvent.kt
index 0e13e0454619..80d929b95563 100644
--- a/core/src/commonMain/kotlin/event/automoderation/AutoModerationRuleConfigurationEvent.kt
+++ b/core/src/commonMain/kotlin/event/automoderation/AutoModerationRuleConfigurationEvent.kt
@@ -31,6 +31,8 @@ public sealed interface AutoModerationRuleConfigurationEvent : AutoModerationEve
  * An [AutoModerationRuleConfigurationEvent] that is sent when an [AutoModerationRule] is created.
  *
  * This event is only sent to bot users which have the [ManageGuild] permission.
+ *
+ * See [Auto moderation rule create](https://discord.com/developers/docs/topics/gateway-events#auto-moderation-rule-create)
  */
 public class AutoModerationRuleCreateEvent(
     /** The [AutoModerationRule] that was created. */
@@ -52,6 +54,8 @@ public class AutoModerationRuleCreateEvent(
  * An [AutoModerationRuleConfigurationEvent] that is sent when an [AutoModerationRule] is updated.
  *
  * This event is only sent to bot users which have the [ManageGuild] permission.
+ *
+ * See [Auto moderation rule update](https://discord.com/developers/docs/topics/gateway-events#auto-moderation-rule-update)
  */
 public class AutoModerationRuleUpdateEvent(
     /** The [AutoModerationRule] that was updated. */
@@ -75,6 +79,8 @@ public class AutoModerationRuleUpdateEvent(
  * An [AutoModerationRuleConfigurationEvent] that is sent when an [AutoModerationRule] is deleted.
  *
  * This event is only sent to bot users which have the [ManageGuild] permission.
+ *
+ * See [Auto moderation rule delete](https://discord.com/developers/docs/topics/gateway-events#auto-moderation-rule-delete)
  */
 public class AutoModerationRuleDeleteEvent(
     /** The [AutoModerationRule] that was deleted. */
diff --git a/core/src/commonMain/kotlin/event/automoderation/data/AutoModerationActionExecutionEventData.kt b/core/src/commonMain/kotlin/event/automoderation/data/AutoModerationActionExecutionEventData.kt
index a5f50c4a9cbb..76fdf72078c0 100644
--- a/core/src/commonMain/kotlin/event/automoderation/data/AutoModerationActionExecutionEventData.kt
+++ b/core/src/commonMain/kotlin/event/automoderation/data/AutoModerationActionExecutionEventData.kt
@@ -7,6 +7,11 @@ import dev.kord.core.cache.data.AutoModerationActionData
 import dev.kord.gateway.DiscordAutoModerationActionExecution
 import kotlinx.serialization.Serializable
 
+/**
+ * The data for the event dispatched when an auto-moderation action is executed.
+ *
+ * See [Auto moderation action execution](https://discord.com/developers/docs/topics/gateway-events#auto-moderation-action-execution)
+ */
 @Serializable
 public data class AutoModerationActionExecutionEventData(
     val guildId: Snowflake,
diff --git a/core/src/commonMain/kotlin/event/channel/ChannelCreateEvent.kt b/core/src/commonMain/kotlin/event/channel/ChannelCreateEvent.kt
index f4f64afbc3a6..dfcabfcb1cdb 100644
--- a/core/src/commonMain/kotlin/event/channel/ChannelCreateEvent.kt
+++ b/core/src/commonMain/kotlin/event/channel/ChannelCreateEvent.kt
@@ -4,12 +4,22 @@ import dev.kord.core.Kord
 import dev.kord.core.entity.channel.*
 import dev.kord.core.event.Event
 
+/**
+ * The event dispatched when a [Channel] is created in a guild.
+ *
+ * See [Channel Create](https://discord.com/developers/docs/topics/gateway-events#channel-create)
+ */
 public interface ChannelCreateEvent : Event {
     public val channel: Channel
     override val kord: Kord
         get() = channel.kord
 }
 
+/**
+ * The event dispatched when a [Category] is created in a guild.
+ *
+ * See [Channel Create](https://discord.com/developers/docs/topics/gateway-events#channel-create)
+ */
 public class CategoryCreateEvent(
     override val channel: Category,
     override val shard: Int,
@@ -20,6 +30,11 @@ public class CategoryCreateEvent(
     }
 }
 
+/**
+ * The event dispatched when a [DmChannel] is created in a guild.
+ *
+ * See [Channel Create](https://discord.com/developers/docs/topics/gateway-events#channel-create)
+ */
 public class DMChannelCreateEvent(
     override val channel: DmChannel,
     override val shard: Int,
@@ -30,6 +45,11 @@ public class DMChannelCreateEvent(
     }
 }
 
+/**
+ * The event dispatched when a [NewsChannel] is created in a guild.
+ *
+ * See [Channel Create](https://discord.com/developers/docs/topics/gateway-events#channel-create)
+ */
 public class NewsChannelCreateEvent(
     override val channel: NewsChannel,
     override val shard: Int,
@@ -40,6 +60,11 @@ public class NewsChannelCreateEvent(
     }
 }
 
+/**
+ * The event dispatched when a [TextChannel] is created in a guild.
+ *
+ * See [Channel Create](https://discord.com/developers/docs/topics/gateway-events#channel-create)
+ */
 public class TextChannelCreateEvent(
     override val channel: TextChannel,
     override val shard: Int,
@@ -50,6 +75,11 @@ public class TextChannelCreateEvent(
     }
 }
 
+/**
+ * The event dispatched when a [VoiceChannel] is created in a guild.
+ *
+ * See [Channel Create](https://discord.com/developers/docs/topics/gateway-events#channel-create)
+ */
 public class VoiceChannelCreateEvent(
     override val channel: VoiceChannel,
     override val shard: Int,
@@ -60,7 +90,11 @@ public class VoiceChannelCreateEvent(
     }
 }
 
-
+/**
+ * The event dispatched when a [StageChannel] is created in a guild.
+ *
+ * See [Channel Create](https://discord.com/developers/docs/topics/gateway-events#channel-create)
+ */
 public class StageChannelCreateEvent(
     override val channel: StageChannel,
     override val shard: Int,
@@ -71,6 +105,11 @@ public class StageChannelCreateEvent(
     }
 }
 
+/**
+ * The event dispatched when a [ForumChannel] is created in a guild.
+ *
+ * See [Channel Create](https://discord.com/developers/docs/topics/gateway-events#channel-create)
+ */
 public class ForumChannelCreateEvent(
     override val channel: ForumChannel,
     override val shard: Int,
@@ -81,6 +120,11 @@ public class ForumChannelCreateEvent(
     }
 }
 
+/**
+ * The event dispatched when a [MediaChannel] is created in a guild.
+ *
+ * See [Channel Create](https://discord.com/developers/docs/topics/gateway-events#channel-create)
+ */
 public class MediaChannelCreateEvent(
     override val channel: MediaChannel,
     override val shard: Int,
@@ -90,6 +134,11 @@ public class MediaChannelCreateEvent(
         "MediaChannelCreateEvent(channel=$channel, shard=$shard, customContext=$customContext)"
 }
 
+/**
+ * The event dispatched when an Unknown [Channel] is created in a guild.
+ *
+ * See [Channel Create](https://discord.com/developers/docs/topics/gateway-events#channel-create)
+ */
 public class UnknownChannelCreateEvent(
     override val channel: Channel,
     override val shard: Int,
diff --git a/core/src/commonMain/kotlin/event/channel/ChannelDeleteEvent.kt b/core/src/commonMain/kotlin/event/channel/ChannelDeleteEvent.kt
index 2ee13d2a6ba4..367309be5b2b 100644
--- a/core/src/commonMain/kotlin/event/channel/ChannelDeleteEvent.kt
+++ b/core/src/commonMain/kotlin/event/channel/ChannelDeleteEvent.kt
@@ -4,12 +4,22 @@ import dev.kord.core.Kord
 import dev.kord.core.entity.channel.*
 import dev.kord.core.event.Event
 
+/**
+ * The event dispatched when a [Channel] is deleted in a guild.
+ *
+ * See [Channel Delete](https://discord.com/developers/docs/topics/gateway-events#channel-delete)
+ */
 public interface ChannelDeleteEvent : Event {
     public val channel: Channel
     override val kord: Kord
         get() = channel.kord
 }
 
+/**
+ * The event dispatched when a [Category] is deleted in a guild.
+ *
+ * See [Channel Delete](https://discord.com/developers/docs/topics/gateway-events#channel-delete)
+ */
 public class CategoryDeleteEvent(
     override val channel: Category,
     override val shard: Int,
@@ -20,6 +30,11 @@ public class CategoryDeleteEvent(
     }
 }
 
+/**
+ * The event dispatched when a [DmChannel] is deleted in a guild.
+ *
+ * See [Channel Delete](https://discord.com/developers/docs/topics/gateway-events#channel-delete)
+ */
 public class DMChannelDeleteEvent(
     override val channel: DmChannel,
     override val shard: Int,
@@ -30,6 +45,11 @@ public class DMChannelDeleteEvent(
     }
 }
 
+/**
+ * The event dispatched when a [NewsChannel] is deleted in a guild.
+ *
+ * See [Channel Delete](https://discord.com/developers/docs/topics/gateway-events#channel-delete)
+ */
 public class NewsChannelDeleteEvent(
     override val channel: NewsChannel,
     override val shard: Int,
@@ -40,6 +60,11 @@ public class NewsChannelDeleteEvent(
     }
 }
 
+/**
+ * The event dispatched when a [TextChannel] is deleted in a guild.
+ *
+ * See [Channel Delete](https://discord.com/developers/docs/topics/gateway-events#channel-delete)
+ */
 public class TextChannelDeleteEvent(
     override val channel: TextChannel,
     override val shard: Int,
@@ -50,6 +75,11 @@ public class TextChannelDeleteEvent(
     }
 }
 
+/**
+ * The event dispatched when a [VoiceChannel] is deleted in a guild.
+ *
+ * See [Channel Delete](https://discord.com/developers/docs/topics/gateway-events#channel-delete)
+ */
 public class VoiceChannelDeleteEvent(
     override val channel: VoiceChannel,
     override val shard: Int,
@@ -60,6 +90,11 @@ public class VoiceChannelDeleteEvent(
     }
 }
 
+/**
+ * The event dispatched when a [StageChannel] is deleted in a guild.
+ *
+ * See [Channel Delete](https://discord.com/developers/docs/topics/gateway-events#channel-delete)
+ */
 public class StageChannelDeleteEvent(
     override val channel: StageChannel,
     override val shard: Int,
@@ -70,6 +105,11 @@ public class StageChannelDeleteEvent(
     }
 }
 
+/**
+ * The event dispatched when a [ForumChannel] is deleted in a guild.
+ *
+ * See [Channel Delete](https://discord.com/developers/docs/topics/gateway-events#channel-delete)
+ */
 public class ForumChannelDeleteEvent(
     override val channel: ForumChannel,
     override val shard: Int,
@@ -80,6 +120,11 @@ public class ForumChannelDeleteEvent(
     }
 }
 
+/**
+ * The event dispatched when a [MediaChannel] is deleted in a guild.
+ *
+ * See [Channel Delete](https://discord.com/developers/docs/topics/gateway-events#channel-delete)
+ */
 public class MediaChannelDeleteEvent(
     override val channel: MediaChannel,
     override val shard: Int,
@@ -89,6 +134,11 @@ public class MediaChannelDeleteEvent(
         "MediaChannelDeleteEvent(channel=$channel, shard=$shard, customContext=$customContext)"
 }
 
+/**
+ * The event dispatched when an Unknown [Channel] is deleted in a guild.
+ *
+ * See [Channel Delete](https://discord.com/developers/docs/topics/gateway-events#channel-delete)
+ */
 public class UnknownChannelDeleteEvent(
     override val channel: Channel,
     override val shard: Int,
diff --git a/core/src/commonMain/kotlin/event/channel/ChannelPinsUpdateEvent.kt b/core/src/commonMain/kotlin/event/channel/ChannelPinsUpdateEvent.kt
index 1bdd798e721a..bad4bbd69193 100644
--- a/core/src/commonMain/kotlin/event/channel/ChannelPinsUpdateEvent.kt
+++ b/core/src/commonMain/kotlin/event/channel/ChannelPinsUpdateEvent.kt
@@ -1,6 +1,7 @@
 package dev.kord.core.event.channel
 
 import dev.kord.common.entity.Snowflake
+import dev.kord.common.exception.RequestException
 import dev.kord.core.Kord
 import dev.kord.core.behavior.GuildBehavior
 import dev.kord.core.behavior.channel.MessageChannelBehavior
@@ -8,12 +9,22 @@ import dev.kord.core.entity.Strategizable
 import dev.kord.core.entity.channel.MessageChannel
 import dev.kord.core.event.Event
 import dev.kord.core.event.channel.data.ChannelPinsUpdateEventData
+import dev.kord.core.exception.EntityNotFoundException
 import dev.kord.core.supplier.EntitySupplier
 import dev.kord.core.supplier.EntitySupplyStrategy
 import dev.kord.core.supplier.getChannelOf
 import dev.kord.core.supplier.getChannelOfOrNull
 import kotlinx.datetime.Instant
 
+/**
+ * The event dispatched when a message is pinned or unpinned in a text channel.
+ *
+ * This event is not sent when a pinned message is deleted.
+ *
+ * See [Channel Pins Update](https://discord.com/developers/docs/topics/gateway-events#channel-pins-update)
+ *
+ * @property data The data associated with the event
+ */
 public class ChannelPinsUpdateEvent(
     public val data: ChannelPinsUpdateEventData,
     override val kord: Kord,
@@ -22,18 +33,44 @@ public class ChannelPinsUpdateEvent(
     override val supplier: EntitySupplier = kord.defaultSupplier,
 ) : Event, Strategizable {
 
+    /**
+     * The ID of the channel that triggered the event
+     */
     public val channelId: Snowflake get() = data.channelId
 
+    /**
+     * The ID of the guild that triggered the event, or null
+     */
     public val guildId: Snowflake? get() = data.guildId.value
 
+    /**
+     * The timestamp of the last pin, or null.
+     */
     public val lastPinTimestamp: Instant? get() = data.lastPinTimestamp.value
 
+    /**
+     * The [Guild][GuildBehavior] that triggered the event, or null.
+     */
     public val guild: GuildBehavior? get() = guildId?.let { GuildBehavior(it, kord) }
 
+    /**
+     * The channel that triggered the event.
+     */
     public val channel: MessageChannelBehavior get() = MessageChannelBehavior(channelId, kord)
 
+    /**
+     * Requests to get the channel for the event as type [MessageChannel]
+     *
+     * @throws RequestException if something went wrong while retrieving the channel.
+     * @throws EntityNotFoundException if the channel is null.
+     */
     public suspend fun getChannel(): MessageChannel = supplier.getChannelOf(channelId)
 
+    /**
+     * Requests to get the channel for the event as type [MessageChannel] or null
+     *
+     * @throws RequestException if something went wrong while retrieving the channel.
+     */
     public suspend fun getChannelOrNull(): MessageChannel? = supplier.getChannelOfOrNull(channelId)
 
     override fun withStrategy(strategy: EntitySupplyStrategy<*>): ChannelPinsUpdateEvent =
diff --git a/core/src/commonMain/kotlin/event/channel/ChannelUpdateEvent.kt b/core/src/commonMain/kotlin/event/channel/ChannelUpdateEvent.kt
index 8e2de0c7b447..e27a14da81f8 100644
--- a/core/src/commonMain/kotlin/event/channel/ChannelUpdateEvent.kt
+++ b/core/src/commonMain/kotlin/event/channel/ChannelUpdateEvent.kt
@@ -4,7 +4,13 @@ import dev.kord.core.Kord
 import dev.kord.core.entity.channel.*
 import dev.kord.core.event.Event
 
-
+/**
+ * The event dispatched when a [Channel] is updated.
+ *
+ * The [old][old] [Channel] may be null unless it has been stored in the cache.
+ *
+ * See [Channel Update](https://discord.com/developers/docs/topics/gateway-events#channel-update)
+ */
 public interface ChannelUpdateEvent : Event {
     public val channel: Channel
     public val old: Channel?
@@ -12,6 +18,13 @@ public interface ChannelUpdateEvent : Event {
         get() = channel.kord
 }
 
+/**
+ * The event dispatched when a [Category] is updated.
+ *
+ * The [old][old] [Category] may be null unless it has been stored in the cache.
+ *
+ * See [Channel Update](https://discord.com/developers/docs/topics/gateway-events#channel-update)
+ */
 public class CategoryUpdateEvent(
     override val channel: Category,
     override val old: Category?,
@@ -23,6 +36,13 @@ public class CategoryUpdateEvent(
     }
 }
 
+/**
+ * The event dispatched when a [DmChannel] is updated.
+ *
+ * The [old][old] [DmChannel] may be null unless it has been stored in the cache.
+ *
+ * See [Channel Update](https://discord.com/developers/docs/topics/gateway-events#channel-update)
+ */
 public class DMChannelUpdateEvent(
     override val channel: DmChannel,
     override val old: DmChannel?,
@@ -34,6 +54,15 @@ public class DMChannelUpdateEvent(
     }
 }
 
+/**
+ * The event dispatched when a [NewsChannel] is updated.
+ *
+ * The [NewsChannel] may have been turned into [TextChannel].
+ *
+ * The [old][old] [NewsChannel] may be null unless it has been stored in the cache.
+ *
+ * See [Channel Update](https://discord.com/developers/docs/topics/gateway-events#channel-update)
+ */
 public class NewsChannelUpdateEvent(
     override val channel: NewsChannel,
     override val old: NewsChannel?,
@@ -45,6 +74,15 @@ public class NewsChannelUpdateEvent(
     }
 }
 
+/**
+ * The event dispatched when a [TextChannel] is updated.
+ *
+ * The [TextChannel] may have been turned into a [NewsChannel].
+ *
+ * The [old][old] [TextChannel] may be null unless it has been stored in the cache.
+ *
+ * See [Channel Update](https://discord.com/developers/docs/topics/gateway-events#channel-update)
+ */
 public class TextChannelUpdateEvent(
     override val channel: TextChannel,
     override val old: TextChannel?,
@@ -56,6 +94,13 @@ public class TextChannelUpdateEvent(
     }
 }
 
+/**
+ * The event dispatched when a [VoiceChannel] is updated.
+ *
+ * The [old] [VoiceChannel] may be null unless it has been stored in the cache.
+ *
+ * See [Channel Update](https://discord.com/developers/docs/topics/gateway-events#channel-update)
+ */
 public class VoiceChannelUpdateEvent(
     override val channel: VoiceChannel,
     override val old: VoiceChannel?,
@@ -67,7 +112,13 @@ public class VoiceChannelUpdateEvent(
     }
 }
 
-
+/**
+ * The event dispatched when a [StageChannel] is updated.
+ *
+ * The [old] [StageChannel] may be null unless it has been stored in the cache.
+ *
+ * See [Channel Update](https://discord.com/developers/docs/topics/gateway-events#channel-update)
+ */
 public class StageChannelUpdateEvent(
     override val channel: StageChannel,
     override val old: StageChannel?,
@@ -79,6 +130,13 @@ public class StageChannelUpdateEvent(
     }
 }
 
+/**
+ * The event dispatched when a [ForumChannel] is updated.
+ *
+ * The [old] [ForumChannel] may be null unless it has been stored in the cache.
+ *
+ * See [Channel Update](https://discord.com/developers/docs/topics/gateway-events#channel-update)
+ */
 public class ForumChannelUpdateEvent(
     override val channel: ForumChannel,
     override val old: ForumChannel?,
@@ -90,6 +148,13 @@ public class ForumChannelUpdateEvent(
     }
 }
 
+/**
+ * The event dispatched when a [MediaChannel] is updated.
+ *
+ * The [old] [MediaChannel] may be null unless it has been stored in the cache.
+ *
+ * See [Channel Update](https://discord.com/developers/docs/topics/gateway-events#channel-update)
+ */
 public class MediaChannelUpdateEvent(
     override val channel: MediaChannel,
     override val old: MediaChannel?,
@@ -100,6 +165,13 @@ public class MediaChannelUpdateEvent(
         "MediaChannelUpdateEvent(channel=$channel, old=$old, shard=$shard, customContext=$customContext)"
 }
 
+/**
+ * The event dispatched when an Unknown [Channel] is updated.
+ *
+ * The [old] Unknown [Channel] may be null unless it has been stored in the cache.
+ *
+ * See [Channel Update](https://discord.com/developers/docs/topics/gateway-events#channel-update)
+ */
 public class UnknownChannelUpdateEvent(
     override val channel: Channel,
     override val old: Channel?,
diff --git a/core/src/commonMain/kotlin/event/channel/TypingStartEvent.kt b/core/src/commonMain/kotlin/event/channel/TypingStartEvent.kt
index 62c1680dce00..650d471ede60 100644
--- a/core/src/commonMain/kotlin/event/channel/TypingStartEvent.kt
+++ b/core/src/commonMain/kotlin/event/channel/TypingStartEvent.kt
@@ -19,6 +19,13 @@ import dev.kord.core.supplier.getChannelOf
 import dev.kord.core.supplier.getChannelOfOrNull
 import kotlinx.datetime.Instant
 
+/**
+ * The event that is dispatched when a user starts typing in a channel.
+ *
+ * @property data The data associated with the event
+ *
+ * See [Typing Start](https://discord.com/developers/docs/topics/gateway-events#typing-start)
+ */
 public class TypingStartEvent(
     public val data: TypingStartEventData,
     override val kord: Kord,
@@ -27,18 +34,39 @@ public class TypingStartEvent(
     override val supplier: EntitySupplier = kord.defaultSupplier,
 ) : Event, Strategizable {
 
+    /**
+     * The ID of the channel that triggered the event.
+     */
     public val channelId: Snowflake get() = data.channelId
 
+    /**
+     * The ID of the user that triggered the event.
+     */
     public val userId: Snowflake get() = data.userId
 
+    /**
+     * The ID of the guild that triggered the event.
+     */
     public val guildId: Snowflake? get() = data.guildId.value
 
+    /**
+     * The [Instant] this event was triggered.
+     */
     public val started: Instant get() = data.timestamp
 
+    /**
+     * The channel that triggered the event.
+     */
     public val channel: MessageChannelBehavior get() = MessageChannelBehavior(channelId, kord)
 
+    /**
+     * The [Guild][GuildBehavior] that triggered the event.
+     */
     public val guild: GuildBehavior? get() = guildId?.let { GuildBehavior(it, kord) }
 
+    /**
+     * The [User][UserBehavior] that triggered the event.
+     */
     public val user: UserBehavior get() = UserBehavior(userId, kord)
 
     /**
diff --git a/core/src/commonMain/kotlin/event/channel/data/ChannelPinsUpdateEventData.kt b/core/src/commonMain/kotlin/event/channel/data/ChannelPinsUpdateEventData.kt
index 15b7623a0eae..842faf348bd2 100644
--- a/core/src/commonMain/kotlin/event/channel/data/ChannelPinsUpdateEventData.kt
+++ b/core/src/commonMain/kotlin/event/channel/data/ChannelPinsUpdateEventData.kt
@@ -7,6 +7,11 @@ import dev.kord.common.entity.optional.OptionalSnowflake
 import kotlinx.datetime.Instant
 import kotlinx.serialization.Serializable
 
+/**
+ * The data for the event dispatched when a message is pinned or unpinned from a text channel.
+ *
+ * See [Channel Pins Update](https://discord.com/developers/docs/topics/gateway-events#channel-pins-update)
+ */
 @Serializable
 public data class ChannelPinsUpdateEventData(
     val guildId: OptionalSnowflake = OptionalSnowflake.Missing,
diff --git a/core/src/commonMain/kotlin/event/channel/data/TypingStartEventData.kt b/core/src/commonMain/kotlin/event/channel/data/TypingStartEventData.kt
index c137c2c9b174..8fc424ab7e64 100644
--- a/core/src/commonMain/kotlin/event/channel/data/TypingStartEventData.kt
+++ b/core/src/commonMain/kotlin/event/channel/data/TypingStartEventData.kt
@@ -8,6 +8,11 @@ import dev.kord.common.entity.optional.OptionalSnowflake
 import dev.kord.common.serialization.InstantInEpochSeconds
 import kotlinx.serialization.Serializable
 
+/**
+ * The data for the event dispatched when a user starts typing in a channel.
+ *
+ * See [Typing Start](https://discord.com/developers/docs/topics/gateway-events#typing-start)
+ */
 @Serializable
 public data class TypingStartEventData(
     val channelId: Snowflake,
diff --git a/core/src/commonMain/kotlin/event/channel/thread/ThreadCreateEvent.kt b/core/src/commonMain/kotlin/event/channel/thread/ThreadCreateEvent.kt
index 8a38ec1230e5..e7f6ec8022b9 100644
--- a/core/src/commonMain/kotlin/event/channel/thread/ThreadCreateEvent.kt
+++ b/core/src/commonMain/kotlin/event/channel/thread/ThreadCreateEvent.kt
@@ -5,11 +5,20 @@ import dev.kord.core.entity.channel.thread.TextChannelThread
 import dev.kord.core.entity.channel.thread.ThreadChannel
 import dev.kord.core.event.channel.ChannelCreateEvent
 
+/**
+ * The event dispatched when a [ThreadChannel] is created in a guild.
+ *
+ * See [Thread Create](https://discord.com/developers/docs/topics/gateway-events#thread-create)
+ */
 public sealed interface ThreadChannelCreateEvent : ChannelCreateEvent {
     override val channel: ThreadChannel
 }
 
-
+/**
+ * The event dispatched when a [TextChannelThread] is created in a guild.
+ *
+ * See [Thread Create](https://discord.com/developers/docs/topics/gateway-events#thread-create)
+ */
 public class TextChannelThreadCreateEvent(
     override val channel: TextChannelThread,
     override val shard: Int,
@@ -20,7 +29,11 @@ public class TextChannelThreadCreateEvent(
     }
 }
 
-
+/**
+ * The event dispatched when a [NewsChannelThread] is created in a guild.
+ *
+ * See [Thread Create](https://discord.com/developers/docs/topics/gateway-events#thread-create)
+ */
 public class NewsChannelThreadCreateEvent(
     override val channel: NewsChannelThread,
     override val shard: Int,
@@ -31,6 +44,11 @@ public class NewsChannelThreadCreateEvent(
     }
 }
 
+/**
+ * The event dispatched when an Unknown [ThreadChannel] is created in a guild.
+ *
+ * See [Thread Create](https://discord.com/developers/docs/topics/gateway-events#thread-create)
+ */
 public class UnknownChannelThreadCreateEvent(
     override val channel: ThreadChannel,
     override val shard: Int,
diff --git a/core/src/commonMain/kotlin/event/channel/thread/ThreadDeleteEvent.kt b/core/src/commonMain/kotlin/event/channel/thread/ThreadDeleteEvent.kt
index 0135b492d9b8..d2366519c464 100644
--- a/core/src/commonMain/kotlin/event/channel/thread/ThreadDeleteEvent.kt
+++ b/core/src/commonMain/kotlin/event/channel/thread/ThreadDeleteEvent.kt
@@ -7,6 +7,11 @@ import dev.kord.core.entity.channel.thread.TextChannelThread
 import dev.kord.core.entity.channel.thread.ThreadChannel
 import dev.kord.core.event.Event
 
+/**
+ * The event dispatched when a [ThreadChannel] is deleted in a guild.
+ *
+ * See [Thread Delete](https://discord.com/developers/docs/topics/gateway-events#thread-delete)
+ */
 public sealed interface ThreadChannelDeleteEvent : Event {
     public val channel: DeletedThreadChannel
 
@@ -17,7 +22,11 @@ public sealed interface ThreadChannelDeleteEvent : Event {
 
 }
 
-
+/**
+ * The event dispatched when a [TextChannelThread] is deleted in a guild.
+ *
+ * See [Thread Delete](https://discord.com/developers/docs/topics/gateway-events#thread-delete)
+ */
 public class TextChannelThreadDeleteEvent(
     override val channel: DeletedThreadChannel,
     override val old: TextChannelThread?,
@@ -29,7 +38,11 @@ public class TextChannelThreadDeleteEvent(
     }
 }
 
-
+/**
+ * The event dispatched when a [NewsChannelThread] is deleted in a guild.
+ *
+ * See [Thread Delete](https://discord.com/developers/docs/topics/gateway-events#thread-delete)
+ */
 public class NewsChannelThreadDeleteEvent(
     override val channel: DeletedThreadChannel,
     override val old: NewsChannelThread?,
@@ -41,7 +54,11 @@ public class NewsChannelThreadDeleteEvent(
     }
 }
 
-
+/**
+ * The event dispatched when an Unknown [ThreadChannel] is deleted in a guild.
+ *
+ * See [Thread Delete](https://discord.com/developers/docs/topics/gateway-events#thread-delete)
+ */
 public class UnknownChannelThreadDeleteEvent(
     override val channel: DeletedThreadChannel,
     override val old: ThreadChannel?,
diff --git a/core/src/commonMain/kotlin/event/channel/thread/ThreadListSyncEvent.kt b/core/src/commonMain/kotlin/event/channel/thread/ThreadListSyncEvent.kt
index 7040ed3c6d99..adcf8a6f9931 100644
--- a/core/src/commonMain/kotlin/event/channel/thread/ThreadListSyncEvent.kt
+++ b/core/src/commonMain/kotlin/event/channel/thread/ThreadListSyncEvent.kt
@@ -2,6 +2,7 @@ package dev.kord.core.event.channel.thread
 
 import dev.kord.common.entity.Snowflake
 import dev.kord.common.entity.optional.orEmpty
+import dev.kord.common.exception.RequestException
 import dev.kord.core.Kord
 import dev.kord.core.behavior.GuildBehavior
 import dev.kord.core.behavior.channel.threads.ThreadParentChannelBehavior
@@ -13,12 +14,19 @@ import dev.kord.core.entity.channel.TopGuildChannel
 import dev.kord.core.entity.channel.thread.ThreadChannel
 import dev.kord.core.entity.channel.thread.ThreadMember
 import dev.kord.core.event.Event
+import dev.kord.core.exception.EntityNotFoundException
 import dev.kord.core.supplier.EntitySupplier
 import dev.kord.core.supplier.EntitySupplyStrategy
 import kotlinx.coroutines.flow.Flow
 import kotlinx.coroutines.flow.filter
 
-
+/**
+ * The event dispatched when a Thread list is synced.
+ *
+ * See [Thread List Sync](https://discord.com/developers/docs/topics/gateway-events#thread-list-sync)
+ *
+ * @property data The data for the sync
+ */
 public class ThreadListSyncEvent(
     public val data: ThreadListSyncData,
     override val kord: Kord,
@@ -26,17 +34,25 @@ public class ThreadListSyncEvent(
     override val customContext: Any?,
     override val supplier: EntitySupplier = kord.defaultSupplier,
 ) : Event, Strategizable {
-
+    /**
+     * The ID of the guild that triggered the event.
+     */
     public val guildId: Snowflake get() = data.guildId
 
+    /**
+     * The [Guild][GuildBehavior] that triggered the event.
+     */
     public val guild: GuildBehavior get() = GuildBehavior(guildId, kord)
 
     /**
-     * the parent channel ids whose threads are being synced.
+     * The parent channel ids whose threads are being synced.
      * If empty, then threads were synced for the entire guild.
      */
     public val channelIds: List<Snowflake> get() = data.channelIds.orEmpty()
 
+    /**
+     * The behavior of the channels that contain threads, if the [channelIds] list is not empty.
+     */
     public val channelBehaviors: List<ThreadParentChannelBehavior>
         get() = channelIds.map {
             ThreadParentChannelBehavior(guildId, it, kord)
@@ -57,14 +73,28 @@ public class ThreadListSyncEvent(
      */
     public val members: List<ThreadMember> get() = data.members.map { ThreadMember(it, kord) }
 
+    /**
+     * Requests to get the [Guild] for the event
+     *
+     * @throws RequestException if something went wrong while retrieving the guild.
+     * @throws EntityNotFoundException if the guild is `null`.
+     */
     public suspend fun getGuild(): Guild {
         return supplier.getGuild(guildId)
     }
 
+    /**
+     * Requests to get the [Guild] for the event, returns `null` when the guild isn't present.
+     *
+     * @throws RequestException if something went wrong while retrieving the guild.
+     */
     public suspend fun getGuildOrNull(): Guild? {
         return supplier.getGuildOrNull(guildId)
     }
 
+    /**
+     * Requests to get the channels as a [Flow] of [TopGuildChannel]s for a guild
+     */
     public val channels: Flow<TopGuildChannel> get() = supplier.getGuildChannels(guildId).filter { it.id in channelIds }
 
     override fun withStrategy(strategy: EntitySupplyStrategy<*>): ThreadListSyncEvent =
diff --git a/core/src/commonMain/kotlin/event/channel/thread/ThreadMemberUpdateEvent.kt b/core/src/commonMain/kotlin/event/channel/thread/ThreadMemberUpdateEvent.kt
index d9e6b84f930e..94d6ce13d899 100644
--- a/core/src/commonMain/kotlin/event/channel/thread/ThreadMemberUpdateEvent.kt
+++ b/core/src/commonMain/kotlin/event/channel/thread/ThreadMemberUpdateEvent.kt
@@ -4,6 +4,13 @@ import dev.kord.core.Kord
 import dev.kord.core.entity.channel.thread.ThreadMember
 import dev.kord.core.event.Event
 
+/**
+ * The event dispatched when a [ThreadMember] for the current user is updated.
+ *
+ * See [Thread Member Update](https://discord.com/developers/docs/topics/gateway-events#thread-member-update)
+ *
+ * @property member The member that triggered the event
+ */
 public class ThreadMemberUpdateEvent(
     public val member: ThreadMember,
     override val kord: Kord,
diff --git a/core/src/commonMain/kotlin/event/channel/thread/ThreadMembersUpdateEvent.kt b/core/src/commonMain/kotlin/event/channel/thread/ThreadMembersUpdateEvent.kt
index 0f9c1ecc5665..9bc0152ea616 100644
--- a/core/src/commonMain/kotlin/event/channel/thread/ThreadMembersUpdateEvent.kt
+++ b/core/src/commonMain/kotlin/event/channel/thread/ThreadMembersUpdateEvent.kt
@@ -8,6 +8,11 @@ import dev.kord.core.cache.data.ThreadMembersUpdateEventData
 import dev.kord.core.entity.channel.thread.ThreadMember
 import dev.kord.core.event.Event
 
+/**
+ * The event dispatched when a guild member is added or removed from a thread.
+ *
+ * See [Thread Members Update](https://discord.com/developers/docs/topics/gateway-events#thread-members-update)
+ */
 public class ThreadMembersUpdateEvent(
     public val data: ThreadMembersUpdateEventData,
     override val kord: Kord,
@@ -15,19 +20,37 @@ public class ThreadMembersUpdateEvent(
     override val customContext: Any?,
 ) : Event {
 
+    /**
+     * The ID of the thread that triggered the event.
+     */
     public val id: Snowflake get() = data.id
 
+    /**
+     * The ID of the guild the event was triggered by.
+     */
     public val guildId: Snowflake get() = data.guildId
 
+    /**
+     * The approximate number of members in this thread. Capped at 50 members.
+     */
     public val memberCount: Int get() = data.memberCount
 
+    /**
+     * The [List] of users added to the thread in this event.
+     */
     public val addedMembers: List<ThreadMember>
         get() = data.addedMembers.orEmpty().map {
             ThreadMember(it, kord)
         }
 
+    /**
+     * The [List] of IDs for the users removed from the thread in this event, or empty if null.
+     */
     public val removedMemberIds: List<Snowflake> get() = data.removedMemberIds.orEmpty()
 
+    /**
+     * The [List] of users removed from the thread in this event as [MemberBehavior]
+     */
     public val removedMemberBehaviors: List<MemberBehavior>
         get() = removedMemberIds.map {
             MemberBehavior(guildId, it, kord)
diff --git a/core/src/commonMain/kotlin/event/channel/thread/ThreadUpdateEvent.kt b/core/src/commonMain/kotlin/event/channel/thread/ThreadUpdateEvent.kt
index 7bbe86dda5d5..1de92e40e95a 100644
--- a/core/src/commonMain/kotlin/event/channel/thread/ThreadUpdateEvent.kt
+++ b/core/src/commonMain/kotlin/event/channel/thread/ThreadUpdateEvent.kt
@@ -5,11 +5,20 @@ import dev.kord.core.entity.channel.thread.TextChannelThread
 import dev.kord.core.entity.channel.thread.ThreadChannel
 import dev.kord.core.event.channel.ChannelUpdateEvent
 
+/**
+ * The event dispatched when a [ThreadChannel] is updated in a guild.
+ *
+ * See [Thread Update](https://discord.com/developers/docs/topics/gateway-events#thread-update)
+ */
 public sealed interface ThreadUpdateEvent : ChannelUpdateEvent {
     override val channel: ThreadChannel
 }
 
-
+/**
+ * The event dispatched when a [TextChannelThread] is updated in a guild.
+ *
+ * See [Thread Update](https://discord.com/developers/docs/topics/gateway-events#thread-update)
+ */
 public class TextChannelThreadUpdateEvent(
     override val channel: TextChannelThread,
     override val old: TextChannelThread?,
@@ -21,7 +30,11 @@ public class TextChannelThreadUpdateEvent(
     }
 }
 
-
+/**
+ * The event dispatched when a [NewsChannelThread] is updated in a guild.
+ *
+ * See [Thread Update](https://discord.com/developers/docs/topics/gateway-events#thread-update)
+ */
 public class NewsChannelThreadUpdateEvent(
     override val channel: NewsChannelThread,
     override val old: NewsChannelThread?,
@@ -33,7 +46,11 @@ public class NewsChannelThreadUpdateEvent(
     }
 }
 
-
+/**
+ * The event dispatched when an Unknown [ThreadChannel] is updated in a guild.
+ *
+ * See [Thread Update](https://discord.com/developers/docs/topics/gateway-events#thread-update)
+ */
 public class UnknownChannelThreadUpdateEvent(
     override val channel: ThreadChannel,
     override val old: ThreadChannel?,
diff --git a/core/src/commonMain/kotlin/event/gateway/Events.kt b/core/src/commonMain/kotlin/event/gateway/Events.kt
index a1aa4be72303..028ea32bd96f 100644
--- a/core/src/commonMain/kotlin/event/gateway/Events.kt
+++ b/core/src/commonMain/kotlin/event/gateway/Events.kt
@@ -15,8 +15,14 @@ import dev.kord.gateway.GatewayCloseCode
 import kotlinx.coroutines.flow.Flow
 import kotlinx.coroutines.flow.filter
 
+/**
+ * A Gateway received an event.
+ */
 public sealed class GatewayEvent : Event
 
+/**
+ * The event dispatched when a bot connects to the Gateway.
+ */
 public class ConnectEvent(
     override val kord: Kord,
     override val shard: Int,
@@ -137,6 +143,15 @@ public sealed class DisconnectEvent : GatewayEvent() {
 
 }
 
+/**
+ * The event sent after the bot sends a valid `Identify` payload.
+ *
+ * @property gatewayVersion The current API version in use
+ * @property guildIds A [Set] of guild IDs for guilds the bot is a member of. These guild objects are unavailable to the bot
+ * @property self The [User] object for the bot
+ * @property sessionId The ID of the session. This is used for resuming connections
+ * @property resumeGatewayUrl The URL of the gateway to use for resuming connections
+ */
 public class ReadyEvent(
     public val gatewayVersion: Int,
     public val guildIds: Set<Snowflake>,
@@ -149,8 +164,16 @@ public class ReadyEvent(
     override val supplier: EntitySupplier = kord.defaultSupplier,
 ) : GatewayEvent(), Strategizable {
 
+    /**
+     * A set of all the [Guild]s the bot is in.
+     */
     public val guilds: Set<GuildBehavior> get() = guildIds.map { GuildBehavior(it, kord) }.toSet()
 
+    /**
+     * Requests to get a flow of all the [Guild]s the bot is in from the [supplier], filtered to those in the [guilds] set.
+     *
+     * @return A flow of [Guild]s the bot is in
+     */
     public fun getGuilds(): Flow<Guild> = supplier.guilds.filter { it.id in guildIds }
 
     override fun withStrategy(strategy: EntitySupplyStrategy<*>): ReadyEvent =
@@ -160,6 +183,9 @@ public class ReadyEvent(
             "sessionId='$sessionId', resumeGatewayUrl=$resumeGatewayUrl, kord=$kord, shard=$shard, supplier=$supplier)"
 }
 
+/**
+ * The event sent when the bot is attempting to reconnect.
+ */
 public class ResumedEvent(
     override val kord: Kord,
     override val shard: Int,
diff --git a/core/src/commonMain/kotlin/event/guild/BanAddEvent.kt b/core/src/commonMain/kotlin/event/guild/BanAddEvent.kt
index 0bdcb12d3adb..79fed38b1d64 100644
--- a/core/src/commonMain/kotlin/event/guild/BanAddEvent.kt
+++ b/core/src/commonMain/kotlin/event/guild/BanAddEvent.kt
@@ -23,6 +23,9 @@ public class BanAddEvent(
 
     override val kord: Kord get() = user.kord
 
+    /**
+     * The [Guild] this event was triggered from
+     */
     public val guild: GuildBehavior get() = GuildBehavior(guildId, kord)
 
     /**
@@ -35,7 +38,7 @@ public class BanAddEvent(
 
     /**
      * Requests to get the [Guild] this ban happened in,
-     * returns null if the guild isn't present.
+     * returns `null` if the guild isn't present.
      *
      * @throws [RequestException] if anything went wrong during the request.
      */
diff --git a/core/src/commonMain/kotlin/event/guild/BanRemoveEvent.kt b/core/src/commonMain/kotlin/event/guild/BanRemoveEvent.kt
index 83fe194bf84a..34f994825057 100644
--- a/core/src/commonMain/kotlin/event/guild/BanRemoveEvent.kt
+++ b/core/src/commonMain/kotlin/event/guild/BanRemoveEvent.kt
@@ -1,12 +1,14 @@
 package dev.kord.core.event.guild
 
 import dev.kord.common.entity.Snowflake
+import dev.kord.common.exception.RequestException
 import dev.kord.core.Kord
 import dev.kord.core.behavior.GuildBehavior
 import dev.kord.core.entity.Guild
 import dev.kord.core.entity.Strategizable
 import dev.kord.core.entity.User
 import dev.kord.core.event.Event
+import dev.kord.core.exception.EntityNotFoundException
 import dev.kord.core.supplier.EntitySupplier
 import dev.kord.core.supplier.EntitySupplyStrategy
 
@@ -20,10 +22,24 @@ public class BanRemoveEvent(
 
     override val kord: Kord get() = user.kord
 
+    /**
+     * The [Guild] this event was triggered from.
+     */
     public val guild: GuildBehavior get() = GuildBehavior(guildId, kord)
 
+    /**
+     * Requests to get the [Guild] this ban was removed from.
+     *
+     * @throws [RequestException] if anything went wrong during the request.
+     * @throws [EntityNotFoundException] if the guild wasn't present.
+     */
     public suspend fun getGuild(): Guild = supplier.getGuild(guildId)
 
+    /**
+     * Requests to get the [Guild] this ban was removed from, or `null` if the guild wasn't present
+     *
+     * @throws [RequestException] if anything went wrong during the request.
+     */
     public suspend fun getGuildOrNull(): Guild? = supplier.getGuildOrNull(guildId)
 
     override fun withStrategy(strategy: EntitySupplyStrategy<*>): BanRemoveEvent =
diff --git a/core/src/commonMain/kotlin/event/guild/EmojisUpdateEvent.kt b/core/src/commonMain/kotlin/event/guild/EmojisUpdateEvent.kt
index 6283da56823d..1df62130f16a 100644
--- a/core/src/commonMain/kotlin/event/guild/EmojisUpdateEvent.kt
+++ b/core/src/commonMain/kotlin/event/guild/EmojisUpdateEvent.kt
@@ -1,15 +1,24 @@
 package dev.kord.core.event.guild
 
 import dev.kord.common.entity.Snowflake
+import dev.kord.common.exception.RequestException
 import dev.kord.core.Kord
 import dev.kord.core.behavior.GuildBehavior
 import dev.kord.core.entity.Guild
 import dev.kord.core.entity.GuildEmoji
 import dev.kord.core.entity.Strategizable
 import dev.kord.core.event.Event
+import dev.kord.core.exception.EntityNotFoundException
 import dev.kord.core.supplier.EntitySupplier
 import dev.kord.core.supplier.EntitySupplyStrategy
 
+/**
+ * The event dispatched when a guild's emojis have been updated.
+ *
+ * The [old][old] [GuildEmoji] set may be `null` unless it has been stored by the cache.
+ *
+ * See [Guild Emoji Update](https://discord.com/developers/docs/topics/gateway-events#guild-emojis-update)
+ */
 public class EmojisUpdateEvent(
     public val guildId: Snowflake,
     public val emojis: Set<GuildEmoji>,
@@ -20,10 +29,24 @@ public class EmojisUpdateEvent(
     override val supplier: EntitySupplier = kord.defaultSupplier,
 ) : Event, Strategizable {
 
+    /**
+     * The guild this event was triggered from.
+     */
     public val guild: GuildBehavior get() = GuildBehavior(guildId, kord)
 
+    /**
+     * Requests to get the [Guild] this update was triggered from.
+     *
+     * @throws [RequestException] if anything went wrong during the request.
+     * @throws [EntityNotFoundException] if the guild wasn't present.
+     */
     public suspend fun getGuild(): Guild = supplier.getGuild(guildId)
 
+    /**
+     * Requests to get the [Guild] this update was triggered from, or `null` if the guild wasn't present.
+     *
+     * @throws [RequestException] if anything went wrong during the request.
+     */
     public suspend fun getGuildOrNull(): Guild? = supplier.getGuildOrNull(guildId)
 
     override fun withStrategy(strategy: EntitySupplyStrategy<*>): EmojisUpdateEvent =
diff --git a/core/src/commonMain/kotlin/event/guild/GuildCreateEvent.kt b/core/src/commonMain/kotlin/event/guild/GuildCreateEvent.kt
index 6df23c11ddbd..6a863caef408 100644
--- a/core/src/commonMain/kotlin/event/guild/GuildCreateEvent.kt
+++ b/core/src/commonMain/kotlin/event/guild/GuildCreateEvent.kt
@@ -4,6 +4,17 @@ import dev.kord.core.Kord
 import dev.kord.core.entity.Guild
 import dev.kord.core.event.Event
 
+/**
+ * The event dispatched in 3 scenarios:
+ * 1. A user is initially connecting, tp lazily load and back-fill information for all unavailable guilds sent in the Ready
+ * event. Guilds that are unavailable due to an outage will send a [GuildDeleteEvent]
+ * 2. When a Guild becomes available again to the client
+ * 3. When the current user joins a new Guild.
+ *
+ *  _Scenarios 1 and 3 may be marked unavailable during an outage_
+ *
+ *  See [Guild Create](https://discord.com/developers/docs/topics/gateway-events#guild-create)
+ */
 public class GuildCreateEvent(
     public val guild: Guild,
     override val shard: Int,
diff --git a/core/src/commonMain/kotlin/event/guild/GuildDeleteEvent.kt b/core/src/commonMain/kotlin/event/guild/GuildDeleteEvent.kt
index a3a42e9a240f..1b58e34ca229 100644
--- a/core/src/commonMain/kotlin/event/guild/GuildDeleteEvent.kt
+++ b/core/src/commonMain/kotlin/event/guild/GuildDeleteEvent.kt
@@ -5,6 +5,13 @@ import dev.kord.core.Kord
 import dev.kord.core.entity.Guild
 import dev.kord.core.event.Event
 
+/**
+ * The event dispatched when a guild becomes, or was already, unavailable due to an outage, or when the user leaves/is
+ * removed from a guild.
+ * If the [unavailable] field was not set, the user was removed from the guild.
+ *
+ * See [Guild Delete](https://discord.com/developers/docs/topics/gateway-events#guild-delete)
+ */
 public class GuildDeleteEvent(
     public val guildId: Snowflake,
     public val unavailable: Boolean,
diff --git a/core/src/commonMain/kotlin/event/guild/GuildScheduledEventCreateEvent.kt b/core/src/commonMain/kotlin/event/guild/GuildScheduledEventCreateEvent.kt
index e4e9d52cb864..2e86983d91d6 100644
--- a/core/src/commonMain/kotlin/event/guild/GuildScheduledEventCreateEvent.kt
+++ b/core/src/commonMain/kotlin/event/guild/GuildScheduledEventCreateEvent.kt
@@ -6,7 +6,9 @@ import dev.kord.core.supplier.EntitySupplier
 import dev.kord.core.supplier.EntitySupplyStrategy
 
 /**
- * Event fired when a scheduled event got created.
+ * The event dispatched when a scheduled guild event was created.
+ *
+ * See [Guild Scheduled Event Create](https://discord.com/developers/docs/topics/gateway-events#guild-scheduled-event-create)
  *
  * @see GuildScheduledEvent
  * @see GuildScheduledEventEvent
diff --git a/core/src/commonMain/kotlin/event/guild/GuildScheduledEventDeleteEvent.kt b/core/src/commonMain/kotlin/event/guild/GuildScheduledEventDeleteEvent.kt
index cec740bda846..9e9566f06b6b 100644
--- a/core/src/commonMain/kotlin/event/guild/GuildScheduledEventDeleteEvent.kt
+++ b/core/src/commonMain/kotlin/event/guild/GuildScheduledEventDeleteEvent.kt
@@ -6,9 +6,11 @@ import dev.kord.core.supplier.EntitySupplier
 import dev.kord.core.supplier.EntitySupplyStrategy
 
 /**
- * Event fired when a scheduled event got deleted.
+ * The event dispatched when a scheduled guild event got deleted.
  * Use [GuildScheduledEvent.status] to know why the event got deleted.
  *
+ * See [Guild Scheduled Event Delete](https://discord.com/developers/docs/topics/gateway-events#guild-scheduled-event-delete)
+ *
  * @see GuildScheduledEvent
  * @see GuildScheduledEvent
  */
diff --git a/core/src/commonMain/kotlin/event/guild/GuildScheduledEventUpdateEvent.kt b/core/src/commonMain/kotlin/event/guild/GuildScheduledEventUpdateEvent.kt
index 2e013605e0fb..348a360d4e39 100644
--- a/core/src/commonMain/kotlin/event/guild/GuildScheduledEventUpdateEvent.kt
+++ b/core/src/commonMain/kotlin/event/guild/GuildScheduledEventUpdateEvent.kt
@@ -9,7 +9,9 @@ import dev.kord.core.supplier.EntitySupplier
 import dev.kord.core.supplier.EntitySupplyStrategy
 
 /**
- * Event fired if a [GuildScheduledEvent] gets updated.
+ * The event dispatched when a [GuildScheduledEvent] gets updated.
+ *
+ * See [Guild Schedule Event Update](https://discord.com/developers/docs/topics/gateway-events#guild-scheduled-event-update)
  *
  * @property scheduledEvent the updated event, for the old event use [oldEvent]
  * @property oldEvent the event that was in the cache before the update
diff --git a/core/src/commonMain/kotlin/event/guild/GuildScheduledEventUserEvent.kt b/core/src/commonMain/kotlin/event/guild/GuildScheduledEventUserEvent.kt
index 8a7d913e74d0..38a9519f12ee 100644
--- a/core/src/commonMain/kotlin/event/guild/GuildScheduledEventUserEvent.kt
+++ b/core/src/commonMain/kotlin/event/guild/GuildScheduledEventUserEvent.kt
@@ -1,38 +1,108 @@
 package dev.kord.core.event.guild
 
 import dev.kord.common.entity.Snowflake
+import dev.kord.common.exception.RequestException
 import dev.kord.core.Kord
 import dev.kord.core.entity.*
 import dev.kord.core.event.Event
+import dev.kord.core.exception.EntityNotFoundException
 import dev.kord.core.supplier.EntitySupplier
 import dev.kord.core.supplier.EntitySupplyStrategy
 
 /**
- * Sent when a user has [subscribed to][GuildScheduledEventUserAddEvent] or
+ * The event dispatched when a user has [subscribed to][GuildScheduledEventUserAddEvent] or
  * [unsubscribed from][GuildScheduledEventUserRemoveEvent] a [GuildScheduledEvent].
+ *
+ * See [Guild Scheduled Event](https://discord.com/developers/docs/topics/gateway-events#guild-scheduled-event-user-add)
  */
 public sealed interface GuildScheduledEventUserEvent : Event, Strategizable {
+    /**
+     * The ID of the scheduled guild event.
+     */
     public val scheduledEventId: Snowflake
+
+    /**
+     * The ID of the user that (un)subscribed from the event.
+     */
     public val userId: Snowflake
+
+    /**
+     * The ID of the guild this event is in.
+     */
     public val guildId: Snowflake
 
+    /**
+     * Requests to get the [User] that (un)subscribed to the event.
+     *
+     * @throws [RequestException] if anything went wrong during the request
+     * @throws [EntityNotFoundException] if the user was not present
+     */
     public suspend fun getUser(): User = supplier.getUser(userId)
+
+    /**
+     * Requests to get the [User] that (un)subscribed to the event, or `null` if the user wasn't present.
+     *
+     * @throws [RequestException] if anything went wrong during the request
+     */
     public suspend fun getUserOrNull(): User? = supplier.getUserOrNull(userId)
 
+
+    /**
+     * Requests to get the [Member] that (un)subscribed to the event.
+     *
+     * @throws [RequestException] if anything went wrong during the request
+     * @throws [EntityNotFoundException] if the member was not present
+     */
     public suspend fun getMember(): Member = supplier.getMember(guildId, userId)
+
+    /**
+     * Requests to get the [Member] that (un)subscribed to the event, or `null` if the member was not present.
+     *
+     * @throws [RequestException] if anything went wrong during the request
+     */
     public suspend fun getMemberOrNull(): Member? = supplier.getMemberOrNull(guildId, userId)
 
+
+    /**
+     * Requests to get the [Guild] that triggered the event.
+     *
+     * @throws [RequestException] if anything went wrong during the request
+     * @throws [EntityNotFoundException] if the guild was not present
+     */
     public suspend fun getGuild(): Guild = supplier.getGuild(guildId)
+
+    /**
+     * Requests to get the [Guild] that triggered the event, or `null` if the guild was not present.
+     *
+     * @throws [RequestException] if anything went wrong during the request
+     */
     public suspend fun getGuildOrNull(): Guild? = supplier.getGuildOrNull(guildId)
 
+
+    /**
+     * Requests to get the [GuildScheduledEvent] that triggered the event.
+     *
+     * @throws [RequestException] if anything went wrong during the request
+     * @throws [EntityNotFoundException] if the event was not present
+     */
     public suspend fun getEvent(): GuildScheduledEvent = supplier.getGuildScheduledEvent(guildId, scheduledEventId)
+
+    /**
+     * Requests to get the [GuildScheduledEvent] that triggered the event, or `null` if the event was not present
+     *
+     * @throws [RequestException] if anything went wrong during the request
+     */
     public suspend fun getEventOrNull(): GuildScheduledEvent? =
         supplier.getGuildScheduledEventOrNull(guildId, scheduledEventId)
 
     override fun withStrategy(strategy: EntitySupplyStrategy<*>): GuildScheduledEventUserEvent
 }
 
-/** Sent when a user has subscribed to a [GuildScheduledEvent]. */
+/**
+ * The event dispatched when a user has subscribed to a [GuildScheduledEvent].
+ *
+ * See [Guild Scheduled Event User Add](https://discord.com/developers/docs/topics/gateway-events#guild-scheduled-event-user-add)
+ */
 public data class GuildScheduledEventUserAddEvent(
     override val scheduledEventId: Snowflake,
     override val userId: Snowflake,
@@ -46,7 +116,11 @@ public data class GuildScheduledEventUserAddEvent(
         GuildScheduledEventUserAddEvent(scheduledEventId, userId, guildId, kord, shard, customContext, strategy.supply(kord))
 }
 
-/** Sent when a user has unsubscribed from a [GuildScheduledEvent]. */
+/**
+ * The event dispatched when a user has unsubscribed from a [GuildScheduledEvent].
+ *
+ * See [Guild Scheduled Event User Remove](https://discord.com/developers/docs/topics/gateway-events#guild-scheduled-event-user-remove)
+ */
 public data class GuildScheduledEventUserRemoveEvent(
     override val scheduledEventId: Snowflake,
     override val userId: Snowflake,
diff --git a/core/src/commonMain/kotlin/event/guild/GuildUpdateEvent.kt b/core/src/commonMain/kotlin/event/guild/GuildUpdateEvent.kt
index bd10aacb484c..3db629568e5a 100644
--- a/core/src/commonMain/kotlin/event/guild/GuildUpdateEvent.kt
+++ b/core/src/commonMain/kotlin/event/guild/GuildUpdateEvent.kt
@@ -4,6 +4,13 @@ import dev.kord.core.Kord
 import dev.kord.core.entity.Guild
 import dev.kord.core.event.Event
 
+/**
+ * The event dispatched when a [Guild] is updated.
+ *
+ * The [old][old] [Guild] may be `null` unless the guild has been stored in the cache.
+ *
+ * See [Guild Update](https://discord.com/developers/docs/topics/gateway-events#guild-update)
+ */
 public class GuildUpdateEvent(
     public val guild: Guild,
     public val old: Guild?,
diff --git a/core/src/commonMain/kotlin/event/guild/IntegrationsUpdateEvent.kt b/core/src/commonMain/kotlin/event/guild/IntegrationsUpdateEvent.kt
index dd2bd1824535..254b671ea383 100644
--- a/core/src/commonMain/kotlin/event/guild/IntegrationsUpdateEvent.kt
+++ b/core/src/commonMain/kotlin/event/guild/IntegrationsUpdateEvent.kt
@@ -1,14 +1,21 @@
 package dev.kord.core.event.guild
 
 import dev.kord.common.entity.Snowflake
+import dev.kord.common.exception.RequestException
 import dev.kord.core.Kord
 import dev.kord.core.behavior.GuildBehavior
 import dev.kord.core.entity.Guild
 import dev.kord.core.entity.Strategizable
 import dev.kord.core.event.Event
+import dev.kord.core.exception.EntityNotFoundException
 import dev.kord.core.supplier.EntitySupplier
 import dev.kord.core.supplier.EntitySupplyStrategy
 
+/**
+ * The event dispatched when the integrations for a guild are updated.
+ *
+ * See [Guild Interactions Update](https://discord.com/developers/docs/topics/gateway-events#guild-integrations-update)
+ */
 public class IntegrationsUpdateEvent(
     public val guildId: Snowflake,
     override val kord: Kord,
@@ -16,11 +23,24 @@ public class IntegrationsUpdateEvent(
     override val customContext: Any?,
     override val supplier: EntitySupplier = kord.defaultSupplier,
 ) : Event, Strategizable {
-
+    /**
+     * The [Guild] that triggered the event.
+     */
     public val guild: GuildBehavior get() = GuildBehavior(guildId, kord)
 
+    /**
+     * Requests to get the [Guild] that triggered the event.
+     *
+     * @throws [RequestException] if anything went wrong during the request
+     * @throws [EntityNotFoundException] if the guild was not present
+     */
     public suspend fun getGuild(): Guild = supplier.getGuild(guildId)
 
+    /**
+     * Requests to get the [Guild] that triggered the event, or `null` if the guild was not present.
+     *
+     * @throws [RequestException] if anything went wrong during the request
+     */
     public suspend fun getGuildOrNull(): Guild? = supplier.getGuildOrNull(guildId)
 
     override fun withStrategy(strategy: EntitySupplyStrategy<*>): IntegrationsUpdateEvent =
diff --git a/core/src/commonMain/kotlin/event/guild/InviteCreateEvent.kt b/core/src/commonMain/kotlin/event/guild/InviteCreateEvent.kt
index 055a4665edbb..384859ec9fc2 100644
--- a/core/src/commonMain/kotlin/event/guild/InviteCreateEvent.kt
+++ b/core/src/commonMain/kotlin/event/guild/InviteCreateEvent.kt
@@ -20,7 +20,9 @@ import kotlinx.datetime.Instant
 import kotlin.time.Duration
 
 /**
- * Sent when a new invite to a channel is created.
+ * The event dispatched when a new invite to a channel is created.
+ *
+ * See [Invite Create](https://discord.com/developers/docs/topics/gateway-events#invite-create)
  */
 public class InviteCreateEvent(
     public val data: InviteCreateData,
@@ -131,13 +133,13 @@ public class InviteCreateEvent(
      * Requests to get the [Channel] this invite is for.
      *
      * @throws [RequestException] if anything went wrong during the request.
-     * @throws [EntityNotFoundException] if the  wasn't present.
+     * @throws [EntityNotFoundException] if the wasn't present.
      */
     public suspend fun getChannel(): Channel = supplier.getChannel(channelId)
 
     /**
      * Requests to get the [Channel] this invite is for,
-     * returns null if the channel isn't present.
+     * returns `null` if the channel isn't present.
      *
      * @throws [RequestException] if anything went wrong during the request.
      */
@@ -145,7 +147,7 @@ public class InviteCreateEvent(
 
     /**
      * Requests to get the [Guild] of the invite.
-     * returns null if the guild isn't present, or if invite does not target a guild.
+     * returns `null` if the guild isn't present, or if invite does not target a guild.
      *
      * @throws [RequestException] if anything went wrong during the request.
      */
@@ -153,7 +155,7 @@ public class InviteCreateEvent(
 
     /**
      * Requests to get the [User] that created the invite,
-     * returns null if the user isn't present or no inviter created this invite.
+     * returns `null` if the user isn't present or no inviter created this invite.
      *
      * @throws [RequestException] if anything went wrong during the request.
      */
@@ -161,7 +163,7 @@ public class InviteCreateEvent(
 
     /**
      * Requests to get the [User] that created the invite as a [Member] of the [Guild][getGuildOrNull],
-     * returns null if the user isn't present, the invite did not target a guild, or no inviter created the event.
+     * returns `null` if the user isn't present, the invite did not target a guild, or no inviter created the event.
      *
      * @throws [RequestException] if anything went wrong during the request.
      */
@@ -171,7 +173,7 @@ public class InviteCreateEvent(
 
     /**
      * Requests to get the target [User] of this invite,
-     * returns null if the user isn't present or the invite did not target a user.
+     * returns `null` if the user isn't present or the invite did not target a user.
      *
      * @throws [RequestException] if anything went wrong during the request.
      */
@@ -179,7 +181,7 @@ public class InviteCreateEvent(
 
     /**
      * Requests to get the target [User] of this invite as a [Member] of the [Guild][getGuildOrNull],
-     * returns null if the user isn't present, the invite did not target a guild, or the invite did not target a user.
+     * returns `null` if the user isn't present, the invite did not target a guild, or the invite did not target a user.
      *
      * @throws [RequestException] if anything went wrong during the request.
      */
diff --git a/core/src/commonMain/kotlin/event/guild/InviteDeleteEvent.kt b/core/src/commonMain/kotlin/event/guild/InviteDeleteEvent.kt
index 811ed52a4bbc..108d99002fbb 100644
--- a/core/src/commonMain/kotlin/event/guild/InviteDeleteEvent.kt
+++ b/core/src/commonMain/kotlin/event/guild/InviteDeleteEvent.kt
@@ -15,7 +15,9 @@ import dev.kord.core.supplier.EntitySupplier
 import dev.kord.core.supplier.EntitySupplyStrategy
 
 /**
- * Sent when an invite is deleted.
+ * The event dispatched when an invite is deleted.
+ *
+ * See [Invite Delete](https://discord.com/developers/docs/topics/gateway-events#invite-delete)
  */
 public class InviteDeleteEvent(
     public val data: InviteDeleteData,
@@ -60,7 +62,7 @@ public class InviteDeleteEvent(
 
     /**
      * Requests to get the [Channel] this invite is for,
-     * returns null if the channel isn't present.
+     * returns `null` if the channel isn't present.
      *
      * @throws [RequestException] if anything went wrong during the request.
      */
@@ -68,7 +70,7 @@ public class InviteDeleteEvent(
 
     /**
      * Requests to get the [Guild] of the invite.
-     * returns null if the guild isn't present, or if invite does not target a guild.
+     * returns `null` if the guild isn't present, or if invite does not target a guild.
      *
      * @throws [RequestException] if anything went wrong during the request.
      */
diff --git a/core/src/commonMain/kotlin/event/guild/MemberJoinEvent.kt b/core/src/commonMain/kotlin/event/guild/MemberJoinEvent.kt
index 0e4029f0293f..9bfd501e9ac8 100644
--- a/core/src/commonMain/kotlin/event/guild/MemberJoinEvent.kt
+++ b/core/src/commonMain/kotlin/event/guild/MemberJoinEvent.kt
@@ -1,15 +1,22 @@
 package dev.kord.core.event.guild
 
 import dev.kord.common.entity.Snowflake
+import dev.kord.common.exception.RequestException
 import dev.kord.core.Kord
 import dev.kord.core.behavior.GuildBehavior
 import dev.kord.core.entity.Guild
 import dev.kord.core.entity.Member
 import dev.kord.core.entity.Strategizable
 import dev.kord.core.event.Event
+import dev.kord.core.exception.EntityNotFoundException
 import dev.kord.core.supplier.EntitySupplier
 import dev.kord.core.supplier.EntitySupplyStrategy
 
+/**
+ * The event dispatched when a new user joins a guild.
+ *
+ * See [Guild Member Add](https://discord.com/developers/docs/topics/gateway-events#guild-member-add)
+ */
 public class MemberJoinEvent(
     public val member: Member,
     override val shard: Int,
@@ -19,12 +26,29 @@ public class MemberJoinEvent(
 
     override val kord: Kord get() = member.kord
 
+    /**
+     * The ID of the guild that triggered this event.
+     */
     public val guildId: Snowflake get() = member.guildId
 
+    /**
+     * The [Guild] that triggered this event.
+     */
     public val guild: GuildBehavior get() = member.guild
 
+    /**
+     * Requests to get the [Guild] that triggered the event.
+     *
+     * @throws [RequestException] if anything went wrong during the request
+     * @throws [EntityNotFoundException] if the guild was not present
+     */
     public suspend fun getGuild(): Guild = supplier.getGuild(guildId)
 
+    /**
+     * Requests to get the [Guild] that triggered the event, or `null` if the guild was not present
+     *
+     * @throws [RequestException] if anything went wrong during the request
+     */
     public suspend fun getGuildOrNull(): Guild? = supplier.getGuildOrNull(guildId)
 
     override fun withStrategy(strategy: EntitySupplyStrategy<*>): MemberJoinEvent =
diff --git a/core/src/commonMain/kotlin/event/guild/MemberLeaveEvent.kt b/core/src/commonMain/kotlin/event/guild/MemberLeaveEvent.kt
index e201cd44ad8c..73db30c53fcb 100644
--- a/core/src/commonMain/kotlin/event/guild/MemberLeaveEvent.kt
+++ b/core/src/commonMain/kotlin/event/guild/MemberLeaveEvent.kt
@@ -1,13 +1,22 @@
 package dev.kord.core.event.guild
 
 import dev.kord.common.entity.Snowflake
+import dev.kord.common.exception.RequestException
 import dev.kord.core.Kord
 import dev.kord.core.behavior.GuildBehavior
 import dev.kord.core.entity.Guild
 import dev.kord.core.entity.Member
 import dev.kord.core.entity.User
 import dev.kord.core.event.Event
-
+import dev.kord.core.exception.EntityNotFoundException
+
+/**
+ * The event dispatched when a user is removed from a guild, via either leave, kick or ban.
+ *
+ * The [old][old] [Member] may be `null` unless it has been stored in the cache.
+ *
+ * See [Guild Member Remove](https://discord.com/developers/docs/topics/gateway-events#guild-member-remove)
+ */
 public class MemberLeaveEvent(
     public val user: User,
     public val old: Member?,
@@ -18,10 +27,24 @@ public class MemberLeaveEvent(
 
     override val kord: Kord get() = user.kord
 
+    /**
+     * The [Guild] that triggered this event.
+     */
     public val guild: GuildBehavior get() = GuildBehavior(guildId, kord)
 
+    /**
+     * Requests to get the [Guild] that triggered the event.
+     *
+     * @throws [RequestException] if anything went wrong during the request
+     * @throws [EntityNotFoundException] if the guild was not present
+     */
     public suspend fun getGuild(): Guild = guild.asGuild()
 
+    /**
+     * Requests to get the [Guild] that triggered the event, or `null` if the guild was not present
+     *
+     * @throws [RequestException] if anything went wrong during the request
+     */
     public suspend fun getGuildOrNull(): Guild? = guild.asGuildOrNull()
 
     override fun toString(): String {
diff --git a/core/src/commonMain/kotlin/event/guild/MemberUpdateEvent.kt b/core/src/commonMain/kotlin/event/guild/MemberUpdateEvent.kt
index 306e393eafb9..ec72dc693de0 100644
--- a/core/src/commonMain/kotlin/event/guild/MemberUpdateEvent.kt
+++ b/core/src/commonMain/kotlin/event/guild/MemberUpdateEvent.kt
@@ -1,15 +1,24 @@
 package dev.kord.core.event.guild
 
 import dev.kord.common.entity.Snowflake
+import dev.kord.common.exception.RequestException
 import dev.kord.core.Kord
 import dev.kord.core.behavior.GuildBehavior
 import dev.kord.core.entity.Guild
 import dev.kord.core.entity.Member
 import dev.kord.core.entity.Strategizable
 import dev.kord.core.event.Event
+import dev.kord.core.exception.EntityNotFoundException
 import dev.kord.core.supplier.EntitySupplier
 import dev.kord.core.supplier.EntitySupplyStrategy
 
+/**
+ * The event dispatched when a guild member is updated. This event is also dispatched when the user object of a guild member changes.
+ *
+ * The [old][old] [Member] may be `null`, unless it has been stored in the cache.
+ *
+ * See [Guild Member Update](https://discord.com/developers/docs/topics/gateway-events#guild-member-update)
+ */
 public class MemberUpdateEvent(
     public val member: Member,
     public val old: Member?,
@@ -18,13 +27,29 @@ public class MemberUpdateEvent(
     override val customContext: Any?,
     override val supplier: EntitySupplier = kord.defaultSupplier,
 ) : Event, Strategizable {
-
+    /**
+     * The ID of the guild that triggered this event.
+     */
     public val guildId: Snowflake get() = member.guildId
 
+    /**
+     * The [Guild] that triggered this event.
+     */
     public val guild: GuildBehavior get() = member.guild
 
+    /**
+     * Requests to get the [Guild] that triggered the event.
+     *
+     * @throws [RequestException] if anything went wrong during the request
+     * @throws [EntityNotFoundException] if the guild was not present
+     */
     public suspend fun getGuild(): Guild = supplier.getGuild(guildId)
 
+    /**
+     * Requests to get the [Guild] that triggered the event, or `null` if the guild was not present
+     *
+     * @throws [RequestException] if anything went wrong during the request
+     */
     public suspend fun getGuildOrNull(): Guild? = supplier.getGuildOrNull(guildId)
 
     override fun withStrategy(strategy: EntitySupplyStrategy<*>): MemberUpdateEvent =
diff --git a/core/src/commonMain/kotlin/event/guild/MembersChunkEvent.kt b/core/src/commonMain/kotlin/event/guild/MembersChunkEvent.kt
index ba4a38aaa8f3..a6f78086b30b 100644
--- a/core/src/commonMain/kotlin/event/guild/MembersChunkEvent.kt
+++ b/core/src/commonMain/kotlin/event/guild/MembersChunkEvent.kt
@@ -2,6 +2,7 @@ package dev.kord.core.event.guild
 
 import dev.kord.common.entity.Snowflake
 import dev.kord.common.entity.optional.orEmpty
+import dev.kord.common.exception.RequestException
 import dev.kord.core.Kord
 import dev.kord.core.behavior.GuildBehavior
 import dev.kord.core.cache.data.MembersChunkData
@@ -10,9 +11,16 @@ import dev.kord.core.entity.Member
 import dev.kord.core.entity.Presence
 import dev.kord.core.entity.Strategizable
 import dev.kord.core.event.Event
+import dev.kord.core.exception.EntityNotFoundException
 import dev.kord.core.supplier.EntitySupplier
 import dev.kord.core.supplier.EntitySupplyStrategy
 
+/**
+ * The event dispatched in response to [Guild Request Members](https://discord.com/developers/docs/topics/gateway-events#request-guild-members).
+ * Using [chunkIndex] and [chunkCount] you cna calculate how many chunks are left for your request.
+ *
+ * See [Guild Members Chunk](https://discord.com/developers/docs/topics/gateway-events#guild-members-chunk)
+ */
 public class MembersChunkEvent(
     public val data: MembersChunkData,
     override val kord: Kord,
@@ -20,28 +28,62 @@ public class MembersChunkEvent(
     override val customContext: Any?,
     override val supplier: EntitySupplier = kord.defaultSupplier,
 ) : Event, Strategizable {
-
+    /**
+     * The ID of the guild that triggered this event.
+     */
     public val guildId: Snowflake get() = data.guildId
 
+    /**
+     * The [Guild] that triggered this event
+     */
     public val guild: GuildBehavior get() = GuildBehavior(guildId, kord)
 
+    /**
+     * A [Set] of guild [Member]s.
+     */
     public val members: Set<Member>
         get() = data.members.zip(data.users)
             .map { (member, user) -> Member(member, user, kord) }
             .toSet()
 
+    /**
+     * The index of the expected chunks for the response. (0 <= [chunkIndex] < [chunkCount])
+     */
     public val chunkIndex: Int get() = data.chunkIndex
 
+    /**
+     * The total number of expected chunks for this response
+     */
     public val chunkCount: Int get() = data.chunkCount
 
+    /**
+     * A [Set] of IDs for users not found in this guild.
+     */
     public val invalidIds: Set<Snowflake> get() = data.notFound.orEmpty()
 
+    /**
+     * A [List] of [Presence]s for the guild [Member]s.
+     */
     public val presences: List<Presence> get() = data.presences.orEmpty().map { Presence(it, kord) }
 
+    /**
+     * The nonce used for the Guild Members request.
+     */
     public val nonce: String? get() = data.nonce.value
 
+    /**
+     * Requests to get the [Guild] that triggered the event.
+     *
+     * @throws [RequestException] if anything went wrong during the request
+     * @throws [EntityNotFoundException] if the guild was not present
+     */
     public suspend fun getGuild(): Guild = supplier.getGuild(guildId)
 
+    /**
+     * Requests to get the [Guild] that triggered the event, or `null` if the guild was not present
+     *
+     * @throws [RequestException] if anything went wrong during the request
+     */
     public suspend fun getGuildOrNull(): Guild? = supplier.getGuildOrNull(guildId)
 
     override fun withStrategy(strategy: EntitySupplyStrategy<*>): MembersChunkEvent =
diff --git a/core/src/commonMain/kotlin/event/guild/VoiceServerUpdateEvent.kt b/core/src/commonMain/kotlin/event/guild/VoiceServerUpdateEvent.kt
index 62d90f402dfd..b58fbb93db02 100644
--- a/core/src/commonMain/kotlin/event/guild/VoiceServerUpdateEvent.kt
+++ b/core/src/commonMain/kotlin/event/guild/VoiceServerUpdateEvent.kt
@@ -1,14 +1,22 @@
 package dev.kord.core.event.guild
 
 import dev.kord.common.entity.Snowflake
+import dev.kord.common.exception.RequestException
 import dev.kord.core.Kord
 import dev.kord.core.behavior.GuildBehavior
 import dev.kord.core.entity.Guild
 import dev.kord.core.entity.Strategizable
 import dev.kord.core.event.Event
+import dev.kord.core.exception.EntityNotFoundException
 import dev.kord.core.supplier.EntitySupplier
 import dev.kord.core.supplier.EntitySupplyStrategy
 
+/**
+ * The event dispatched when a guild's voice server is updated. It is dispatched when initially connecting to voice,
+ * and when the current voice instance falls over into a new server.
+ *
+ * See [Voice Server Update](https://discord.com/developers/docs/topics/gateway-events#voice-server-update)
+ */
 public class VoiceServerUpdateEvent(
     public val token: String,
     public val guildId: Snowflake,
@@ -18,11 +26,24 @@ public class VoiceServerUpdateEvent(
     override val customContext: Any?,
     override val supplier: EntitySupplier = kord.defaultSupplier,
 ) : Event, Strategizable {
-
+    /**
+     * The [Guild] that triggered this event.
+     */
     public val guild: GuildBehavior get() = GuildBehavior(guildId, kord)
 
+    /**
+     * Requests to get the [Guild] that triggered the event.
+     *
+     * @throws [RequestException] if anything went wrong during the request
+     * @throws [EntityNotFoundException] if the guild was not present
+     */
     public suspend fun getGuild(): Guild = supplier.getGuild(guildId)
 
+    /**
+     * Requests to get the [Guild] that triggered the event, or `null` if the guild was not present
+     *
+     * @throws [RequestException] if anything went wrong during the request
+     */
     public suspend fun getGuildOrNull(): Guild? = supplier.getGuildOrNull(guildId)
 
     override fun withStrategy(strategy: EntitySupplyStrategy<*>): VoiceServerUpdateEvent =
diff --git a/core/src/commonMain/kotlin/event/guild/WebhookUpdateEvent.kt b/core/src/commonMain/kotlin/event/guild/WebhookUpdateEvent.kt
index d23bc9f7b268..077d99339e4c 100644
--- a/core/src/commonMain/kotlin/event/guild/WebhookUpdateEvent.kt
+++ b/core/src/commonMain/kotlin/event/guild/WebhookUpdateEvent.kt
@@ -1,6 +1,7 @@
 package dev.kord.core.event.guild
 
 import dev.kord.common.entity.Snowflake
+import dev.kord.common.exception.RequestException
 import dev.kord.core.Kord
 import dev.kord.core.behavior.GuildBehavior
 import dev.kord.core.behavior.channel.TopGuildMessageChannelBehavior
@@ -8,11 +9,17 @@ import dev.kord.core.entity.Guild
 import dev.kord.core.entity.Strategizable
 import dev.kord.core.entity.channel.TopGuildMessageChannel
 import dev.kord.core.event.Event
+import dev.kord.core.exception.EntityNotFoundException
 import dev.kord.core.supplier.EntitySupplier
 import dev.kord.core.supplier.EntitySupplyStrategy
 import dev.kord.core.supplier.getChannelOf
 import dev.kord.core.supplier.getChannelOfOrNull
 
+/**
+ * The event dispatched when a guild channel's webhook is created, update, or deleted.
+ *
+ * See [Webhooks update](https://discord.com/developers/docs/topics/gateway-events#webhooks-update)
+ */
 public class WebhookUpdateEvent(
     public val guildId: Snowflake,
     public val channelId: Snowflake,
@@ -21,17 +28,44 @@ public class WebhookUpdateEvent(
     override val customContext: Any?,
     override val supplier: EntitySupplier = kord.defaultSupplier,
 ) : Event, Strategizable {
-
+    /**
+     * The [channel][TopGuildMessageChannel] that triggered this event.
+     */
     public val channel: TopGuildMessageChannelBehavior get() = TopGuildMessageChannelBehavior(guildId, channelId, kord)
 
+    /**
+     * The [Guild] that triggered this event.
+     */
     public val guild: GuildBehavior get() = GuildBehavior(guildId, kord)
 
+    /**
+     * Requests to get the [TopGuildMessageChannel] that triggered the event.
+     *
+     * @throws [RequestException] if anything went wrong during the request
+     * @throws [EntityNotFoundException] if the channel was not present
+     */
     public suspend fun getChannel(): TopGuildMessageChannel = supplier.getChannelOf(channelId)
 
+    /**
+     * Requests to get the [TopGuildMessageChannel] that triggered the event, or `null` if the channel was not present
+     *
+     * @throws [RequestException] if anything went wrong during the request
+     */
     public suspend fun getChannelOrNull(): TopGuildMessageChannel? = supplier.getChannelOfOrNull(channelId)
 
+    /**
+     * Requests to get the [Guild] that triggered the event.
+     *
+     * @throws [RequestException] if anything went wrong during the request
+     * @throws [EntityNotFoundException] if the guild was not present
+     */
     public suspend fun getGuild(): Guild = guild.asGuild()
 
+    /**
+     * Requests to get the [Guild] that triggered the event, or `null` if the guild was not present
+     *
+     * @throws [RequestException] if anything went wrong during the request
+     */
     public suspend fun getGuildOrNull(): Guild? = guild.asGuildOrNull()
 
     override fun withStrategy(strategy: EntitySupplyStrategy<*>): WebhookUpdateEvent =
diff --git a/core/src/commonMain/kotlin/event/interaction/ApplicationCommandCreate.kt b/core/src/commonMain/kotlin/event/interaction/ApplicationCommandCreate.kt
index 60c296bb035a..519cace5d0a4 100644
--- a/core/src/commonMain/kotlin/event/interaction/ApplicationCommandCreate.kt
+++ b/core/src/commonMain/kotlin/event/interaction/ApplicationCommandCreate.kt
@@ -4,6 +4,13 @@ import dev.kord.core.Kord
 import dev.kord.core.entity.application.*
 import dev.kord.core.event.Event
 
+/**
+ * The event dispatched when an Application command is created.
+ *
+ * See [Application command create](https://discord.com/developers/docs/interactions/application-commands#create-global-application-command)
+ *
+ * @property command The [GuildApplicationCommand] being created
+ */
 
 @Deprecated(
     "This event is not supposed to be sent to bots. See https://github.com/discord/discord-api-docs/issues/3690 for " +
@@ -14,6 +21,11 @@ public sealed interface ApplicationCommandCreateEvent : Event {
     public val command: GuildApplicationCommand
 }
 
+/**
+ * The event dispatched when a Chat Input command is created.
+ *
+ * @see ApplicationCommandCreateEvent
+ */
 @Suppress("DEPRECATION_ERROR")
 @Deprecated(
     "This event is not supposed to be sent to bots. See https://github.com/discord/discord-api-docs/issues/3690 for " +
@@ -27,6 +39,11 @@ public class ChatInputCommandCreateEvent(
     override val customContext: Any?,
 ) : ApplicationCommandCreateEvent
 
+/**
+ * The event dispatched when a User command is created.
+ *
+ * @see ApplicationCommandCreateEvent
+ */
 
 @Suppress("DEPRECATION_ERROR")
 @Deprecated(
@@ -41,6 +58,11 @@ public class UserCommandCreateEvent(
     override val customContext: Any?,
 ) : ApplicationCommandCreateEvent
 
+/**
+ * The event dispatched when a Message command is created.
+ *
+ * @see ApplicationCommandCreateEvent
+ */
 
 @Suppress("DEPRECATION_ERROR")
 @Deprecated(
@@ -55,6 +77,11 @@ public class MessageCommandCreateEvent(
     override val customContext: Any?,
 ) : ApplicationCommandCreateEvent
 
+/**
+ * The event dispatched when an Unknown application command is created.
+ *
+ * @see ApplicationCommandCreateEvent
+ */
 
 @Suppress("DEPRECATION_ERROR")
 @Deprecated(
diff --git a/core/src/commonMain/kotlin/event/interaction/ApplicationCommandDelete.kt b/core/src/commonMain/kotlin/event/interaction/ApplicationCommandDelete.kt
index ba2f859353e7..4efc49f42804 100644
--- a/core/src/commonMain/kotlin/event/interaction/ApplicationCommandDelete.kt
+++ b/core/src/commonMain/kotlin/event/interaction/ApplicationCommandDelete.kt
@@ -4,6 +4,13 @@ import dev.kord.core.Kord
 import dev.kord.core.entity.application.*
 import dev.kord.core.event.Event
 
+/**
+ * The event dispatched when an Application command is deleted.
+ *
+ * See [Application command create](https://discord.com/developers/docs/interactions/application-commands#create-global-application-command)
+ *
+ * @property command The [GuildApplicationCommand] being deleted
+ */
 
 @Deprecated(
     "This event is not supposed to be sent to bots. See https://github.com/discord/discord-api-docs/issues/3690 for " +
@@ -14,6 +21,11 @@ public sealed interface ApplicationCommandDeleteEvent : Event {
     public val command: GuildApplicationCommand
 }
 
+/**
+ * The event dispatched when a chat input command is deleted.
+ *
+ * @see ApplicationCommandDeleteEvent
+ */
 @Suppress("DEPRECATION_ERROR")
 @Deprecated(
     "This event is not supposed to be sent to bots. See https://github.com/discord/discord-api-docs/issues/3690 for " +
@@ -27,6 +39,11 @@ public class ChatInputCommandDeleteEvent(
     override val customContext: Any?,
 ) : ApplicationCommandDeleteEvent
 
+/**
+ * The event dispatched when a user command is deleted.
+ *
+ * @see ApplicationCommandDeleteEvent
+ */
 
 @Suppress("DEPRECATION_ERROR")
 @Deprecated(
@@ -41,6 +58,11 @@ public class UserCommandDeleteEvent(
     override val customContext: Any?,
 ) : ApplicationCommandDeleteEvent
 
+/**
+ * The event dispatched when a message command is deleted.
+ *
+ * @see ApplicationCommandDeleteEvent
+ */
 
 @Suppress("DEPRECATION_ERROR")
 @Deprecated(
@@ -55,6 +77,11 @@ public class MessageCommandDeleteEvent(
     override val customContext: Any?,
 ) : ApplicationCommandDeleteEvent
 
+/**
+ * The event dispatched when an unknown application command is deleted.
+ *
+ * @see ApplicationCommandDeleteEvent
+ */
 
 @Suppress("DEPRECATION_ERROR")
 @Deprecated(
diff --git a/core/src/commonMain/kotlin/event/interaction/ApplicationCommandInteractionCreate.kt b/core/src/commonMain/kotlin/event/interaction/ApplicationCommandInteractionCreate.kt
index 731e6e4f7871..38e807a552a3 100644
--- a/core/src/commonMain/kotlin/event/interaction/ApplicationCommandInteractionCreate.kt
+++ b/core/src/commonMain/kotlin/event/interaction/ApplicationCommandInteractionCreate.kt
@@ -4,31 +4,31 @@ import dev.kord.core.Kord
 import dev.kord.core.entity.interaction.*
 import dev.kord.core.event.Event
 
-/** An [Event] that fires when an [ApplicationCommandInteraction] is created. */
+/** The [Event] dispatched when an [ApplicationCommandInteraction] is created. */
 public sealed interface ApplicationCommandInteractionCreateEvent : ActionInteractionCreateEvent {
     override val interaction: ApplicationCommandInteraction
 }
 
 
-/** An [Event] that fires when a [GlobalApplicationCommandInteraction] is created. */
+/** The [Event] dispatched when a [GlobalApplicationCommandInteraction] is created. */
 public sealed interface GlobalApplicationCommandInteractionCreateEvent :
     ApplicationCommandInteractionCreateEvent {
     override val interaction: GlobalApplicationCommandInteraction
 }
 
-/** An [Event] that fires when a [GuildApplicationCommandInteraction] is created. */
+/** The [Event] dispatched when a [GuildApplicationCommandInteraction] is created. */
 public sealed interface GuildApplicationCommandInteractionCreateEvent :
     ApplicationCommandInteractionCreateEvent {
     override val interaction: GuildApplicationCommandInteraction
 }
 
 
-/** An [Event] that fires when a [UserCommandInteraction] is created. */
+/** The [Event] dispatched when a [UserCommandInteraction] is created. */
 public sealed interface UserCommandInteractionCreateEvent : ApplicationCommandInteractionCreateEvent {
     override val interaction: UserCommandInteraction
 }
 
-/** An [Event] that fires when a [GuildUserCommandInteraction] is created. */
+/** The [Event] dispatched when a [GuildUserCommandInteraction] is created. */
 public class GuildUserCommandInteractionCreateEvent(
     override val interaction: GuildUserCommandInteraction,
     override val kord: Kord,
@@ -36,7 +36,7 @@ public class GuildUserCommandInteractionCreateEvent(
     override val customContext: Any?,
 ) : GuildApplicationCommandInteractionCreateEvent, UserCommandInteractionCreateEvent
 
-/** An [Event] that fires when a [GlobalUserCommandInteraction] is created. */
+/** The [Event] dispatched when a [GlobalUserCommandInteraction] is created. */
 public class GlobalUserCommandInteractionCreateEvent(
     override val interaction: GlobalUserCommandInteraction,
     override val kord: Kord,
@@ -45,12 +45,12 @@ public class GlobalUserCommandInteractionCreateEvent(
 ) : GlobalApplicationCommandInteractionCreateEvent, UserCommandInteractionCreateEvent
 
 
-/** An [Event] that fires when a [MessageCommandInteraction] is created. */
+/** The [Event] dispatched when a [MessageCommandInteraction] is created. */
 public sealed interface MessageCommandInteractionCreateEvent : ApplicationCommandInteractionCreateEvent {
     override val interaction: MessageCommandInteraction
 }
 
-/** An [Event] that fires when a [GuildMessageCommandInteraction] is created. */
+/** The [Event] dispatched when a [GuildMessageCommandInteraction] is created. */
 public class GuildMessageCommandInteractionCreateEvent(
     override val interaction: GuildMessageCommandInteraction,
     override val kord: Kord,
@@ -58,7 +58,7 @@ public class GuildMessageCommandInteractionCreateEvent(
     override val customContext: Any?,
 ) : GuildApplicationCommandInteractionCreateEvent, MessageCommandInteractionCreateEvent
 
-/** An [Event] that fires when a [GlobalMessageCommandInteraction] is created. */
+/** The [Event] dispatched when a [GlobalMessageCommandInteraction] is created. */
 public class GlobalMessageCommandInteractionCreateEvent(
     override val interaction: GlobalMessageCommandInteraction,
     override val kord: Kord,
@@ -67,12 +67,12 @@ public class GlobalMessageCommandInteractionCreateEvent(
 ) : GlobalApplicationCommandInteractionCreateEvent, MessageCommandInteractionCreateEvent
 
 
-/** An [Event] that fires when a [ChatInputCommandInteraction] is created. */
+/** The [Event] dispatched when a [ChatInputCommandInteraction] is created. */
 public sealed interface ChatInputCommandInteractionCreateEvent : ApplicationCommandInteractionCreateEvent {
     override val interaction: ChatInputCommandInteraction
 }
 
-/** An [Event] that fires when a [GuildChatInputCommandInteraction] is created. */
+/** The [Event] dispatched when a [GuildChatInputCommandInteraction] is created. */
 public class GuildChatInputCommandInteractionCreateEvent(
     override val interaction: GuildChatInputCommandInteraction,
     override val kord: Kord,
@@ -80,7 +80,7 @@ public class GuildChatInputCommandInteractionCreateEvent(
     override val customContext: Any?,
 ) : GuildApplicationCommandInteractionCreateEvent, ChatInputCommandInteractionCreateEvent
 
-/** An [Event] that fires when a [GlobalChatInputCommandInteraction] is created. */
+/** The [Event] dispatched when a [GlobalChatInputCommandInteraction] is created. */
 public class GlobalChatInputCommandInteractionCreateEvent(
     override val interaction: GlobalChatInputCommandInteraction,
     override val kord: Kord,
diff --git a/core/src/commonMain/kotlin/event/interaction/ApplicationCommandPermissionsUpdateEvent.kt b/core/src/commonMain/kotlin/event/interaction/ApplicationCommandPermissionsUpdateEvent.kt
index b07e754bfc48..800c70d9d082 100644
--- a/core/src/commonMain/kotlin/event/interaction/ApplicationCommandPermissionsUpdateEvent.kt
+++ b/core/src/commonMain/kotlin/event/interaction/ApplicationCommandPermissionsUpdateEvent.kt
@@ -4,6 +4,13 @@ import dev.kord.core.Kord
 import dev.kord.core.entity.application.ApplicationCommandPermissions
 import dev.kord.core.event.Event
 
+/**
+ * The event dispatched when an [ApplicationCommandPermissions] are updated.
+ *
+ * See [application command permissions update](https://discord.com/developers/docs/interactions/application-commands#edit-application-command-permissions)
+ *
+ * @param permissions The [ApplicationCommandPermissions] for the command
+ */
 public class ApplicationCommandPermissionsUpdateEvent(
     public val permissions: ApplicationCommandPermissions,
     override val kord: Kord,
diff --git a/core/src/commonMain/kotlin/event/interaction/ApplicationCommandUpdate.kt b/core/src/commonMain/kotlin/event/interaction/ApplicationCommandUpdate.kt
index daf181e4a5ab..014cb59bb281 100644
--- a/core/src/commonMain/kotlin/event/interaction/ApplicationCommandUpdate.kt
+++ b/core/src/commonMain/kotlin/event/interaction/ApplicationCommandUpdate.kt
@@ -4,6 +4,13 @@ import dev.kord.core.Kord
 import dev.kord.core.entity.application.*
 import dev.kord.core.event.Event
 
+/**
+ * The event dispatched when an [GuildApplicationCommand] is updated.
+ *
+ * See [application command update](https://discord.com/developers/docs/interactions/application-commands#edit-guild-application-command)
+ *
+ * @property command The command that was updated
+ */
 
 @Deprecated(
     "This event is not supposed to be sent to bots. See https://github.com/discord/discord-api-docs/issues/3690 for " +
@@ -14,6 +21,11 @@ public sealed interface ApplicationCommandUpdateEvent : Event {
     public val command: GuildApplicationCommand
 }
 
+/**
+ * The event dispatched when a [GuildChatInputCommand] is updated
+ *
+ * @see ApplicationCommandUpdateEvent
+ */
 @Suppress("DEPRECATION_ERROR")
 @Deprecated(
     "This event is not supposed to be sent to bots. See https://github.com/discord/discord-api-docs/issues/3690 for " +
@@ -27,6 +39,11 @@ public class ChatInputCommandUpdateEvent(
     override val customContext: Any?,
 ) : ApplicationCommandUpdateEvent
 
+/**
+ * The event dispatched when a [GuildUserCommand] is updated
+ *
+ * @see ApplicationCommandUpdateEvent
+ */
 
 @Suppress("DEPRECATION_ERROR")
 @Deprecated(
@@ -41,6 +58,11 @@ public class UserCommandUpdateEvent(
     override val customContext: Any?,
 ) : ApplicationCommandUpdateEvent
 
+/**
+ * The event dispatched when a [GuildMessageCommand] is updated
+ *
+ * @see ApplicationCommandUpdateEvent
+ */
 
 @Suppress("DEPRECATION_ERROR")
 @Deprecated(
@@ -55,6 +77,11 @@ public class MessageCommandUpdateEvent(
     override val customContext: Any?,
 ) : ApplicationCommandUpdateEvent
 
+/**
+ * The event dispatched when an [UnknownGuildApplicationCommand] is updated
+ *
+ * @see ApplicationCommandUpdateEvent
+ */
 @Suppress("DEPRECATION_ERROR")
 @Deprecated(
     "This event is not supposed to be sent to bots. See https://github.com/discord/discord-api-docs/issues/3690 for " +
diff --git a/core/src/commonMain/kotlin/event/interaction/AutoCompleteInteractionCreate.kt b/core/src/commonMain/kotlin/event/interaction/AutoCompleteInteractionCreate.kt
index d6d74ee1605e..f6bfc0be47ab 100644
--- a/core/src/commonMain/kotlin/event/interaction/AutoCompleteInteractionCreate.kt
+++ b/core/src/commonMain/kotlin/event/interaction/AutoCompleteInteractionCreate.kt
@@ -6,12 +6,12 @@ import dev.kord.core.entity.interaction.GlobalAutoCompleteInteraction
 import dev.kord.core.entity.interaction.GuildAutoCompleteInteraction
 import dev.kord.core.event.Event
 
-/** An [Event] that fires when an [AutoCompleteInteraction] is created. */
+/** The [Event] dispatched when an [AutoCompleteInteraction] is created. */
 public sealed interface AutoCompleteInteractionCreateEvent : DataInteractionCreateEvent {
     override val interaction: AutoCompleteInteraction
 }
 
-/** An [Event] that fires when a [GlobalAutoCompleteInteraction] is created. */
+/** The [Event] dispatched when a [GlobalAutoCompleteInteraction] is created. */
 public class GlobalAutoCompleteInteractionCreateEvent(
     override val kord: Kord,
     override val shard: Int,
@@ -19,7 +19,7 @@ public class GlobalAutoCompleteInteractionCreateEvent(
     override val customContext: Any?,
 ) : AutoCompleteInteractionCreateEvent
 
-/** An [Event] that fires when a [GuildAutoCompleteInteraction] is created. */
+/** The [Event] dispatched when a [GuildAutoCompleteInteraction] is created. */
 public class GuildAutoCompleteInteractionCreateEvent(
     override val kord: Kord,
     override val shard: Int,
diff --git a/core/src/commonMain/kotlin/event/interaction/ComponentInteractionCreate.kt b/core/src/commonMain/kotlin/event/interaction/ComponentInteractionCreate.kt
index 455d7a558d0e..d755aaed6d49 100644
--- a/core/src/commonMain/kotlin/event/interaction/ComponentInteractionCreate.kt
+++ b/core/src/commonMain/kotlin/event/interaction/ComponentInteractionCreate.kt
@@ -4,32 +4,32 @@ import dev.kord.core.Kord
 import dev.kord.core.entity.interaction.*
 import dev.kord.core.event.Event
 
-/** An [Event] that fires when a [ComponentInteraction] is created. */
+/** The [Event] dispatched when a [ComponentInteraction] is created. */
 public sealed interface ComponentInteractionCreateEvent : ActionInteractionCreateEvent {
     override val interaction: ComponentInteraction
 }
 
-/** An [Event] that fires when a [GlobalComponentInteraction] is created. */
+/** The [Event] dispatched when a [GlobalComponentInteraction] is created. */
 public sealed interface GlobalComponentInteractionCreateEvent : ComponentInteractionCreateEvent {
     override val interaction: GlobalComponentInteraction
 }
 
-/** An [Event] that fires when a [GuildComponentInteraction] is created. */
+/** The [Event] dispatched when a [GuildComponentInteraction] is created. */
 public sealed interface GuildComponentInteractionCreateEvent : ComponentInteractionCreateEvent {
     override val interaction: GuildComponentInteraction
 }
 
-/** An [Event] that fires when a [ButtonInteraction] is created. */
+/** The [Event] dispatched when a [ButtonInteraction] is created. */
 public sealed interface ButtonInteractionCreateEvent : ComponentInteractionCreateEvent {
     override val interaction: ButtonInteraction
 }
 
-/** An [Event] that fires when a [SelectMenuInteraction] is created. */
+/** The [Event] dispatched when a [SelectMenuInteraction] is created. */
 public sealed interface SelectMenuInteractionCreateEvent : ComponentInteractionCreateEvent {
     override val interaction: SelectMenuInteraction
 }
 
-/** An [Event] that fires when a [GuildButtonInteraction] is created. */
+/** The [Event] dispatched when a [GuildButtonInteraction] is created. */
 public class GuildButtonInteractionCreateEvent(
     override val interaction: GuildButtonInteraction,
     override val kord: Kord,
@@ -37,7 +37,7 @@ public class GuildButtonInteractionCreateEvent(
     override val customContext: Any?,
 ) : ButtonInteractionCreateEvent, GuildComponentInteractionCreateEvent
 
-/** An [Event] that fires when a [GlobalButtonInteraction] is created. */
+/** The [Event] dispatched when a [GlobalButtonInteraction] is created. */
 public class GlobalButtonInteractionCreateEvent(
     override val interaction: GlobalButtonInteraction,
     override val kord: Kord,
@@ -45,7 +45,7 @@ public class GlobalButtonInteractionCreateEvent(
     override val customContext: Any?,
 ) : ButtonInteractionCreateEvent, GlobalComponentInteractionCreateEvent
 
-/** An [Event] that fires when a [GuildSelectMenuInteraction] is created. */
+/** The [Event] dispatched when a [GuildSelectMenuInteraction] is created. */
 public class GuildSelectMenuInteractionCreateEvent(
     override val interaction: GuildSelectMenuInteraction,
     override val kord: Kord,
@@ -53,7 +53,7 @@ public class GuildSelectMenuInteractionCreateEvent(
     override val customContext: Any?,
 ) : SelectMenuInteractionCreateEvent, GuildComponentInteractionCreateEvent
 
-/** An [Event] that fires when a [GlobalSelectMenuInteraction] is created. */
+/** The [Event] dispatched when a [GlobalSelectMenuInteraction] is created. */
 public class GlobalSelectMenuInteractionCreateEvent(
     override val interaction: GlobalSelectMenuInteraction,
     override val kord: Kord,
diff --git a/core/src/commonMain/kotlin/event/interaction/InteractionCreate.kt b/core/src/commonMain/kotlin/event/interaction/InteractionCreate.kt
index 53fc045b757f..2ef378b84886 100644
--- a/core/src/commonMain/kotlin/event/interaction/InteractionCreate.kt
+++ b/core/src/commonMain/kotlin/event/interaction/InteractionCreate.kt
@@ -7,7 +7,7 @@ import dev.kord.core.entity.interaction.Interaction
 import dev.kord.core.event.Event
 
 /**
- * An [Event] that fires when an [Interaction] is created.
+ * The [Event] dispatched when an [Interaction] is created.
  *
  * The event should be responded to within 3 seconds. See the methods and extensions of each [Interaction] type for
  * ways to respond to the particular interaction.
@@ -19,12 +19,12 @@ public sealed interface InteractionCreateEvent : Event {
     public val interaction: Interaction
 }
 
-/** An [Event] that fires when an [ActionInteraction] is created. */
+/** The [Event] dispatched when an [ActionInteraction] is created. */
 public sealed interface ActionInteractionCreateEvent : InteractionCreateEvent {
     override val interaction: ActionInteraction
 }
 
-/** An [Event] that fires when a [DataInteraction] is created. */
+/** The [Event] dispatched when a [DataInteraction] is created. */
 public sealed interface DataInteractionCreateEvent : InteractionCreateEvent {
     override val interaction: DataInteraction
 }
diff --git a/core/src/commonMain/kotlin/event/interaction/ModalSubmitInteractionCreate.kt b/core/src/commonMain/kotlin/event/interaction/ModalSubmitInteractionCreate.kt
index 0ad7ac76ad23..050a4a6d3a3e 100644
--- a/core/src/commonMain/kotlin/event/interaction/ModalSubmitInteractionCreate.kt
+++ b/core/src/commonMain/kotlin/event/interaction/ModalSubmitInteractionCreate.kt
@@ -6,12 +6,12 @@ import dev.kord.core.entity.interaction.GuildModalSubmitInteraction
 import dev.kord.core.entity.interaction.ModalSubmitInteraction
 import dev.kord.core.event.Event
 
-/** An [Event] that fires when a [ModalSubmitInteraction] is created. */
+/** The [Event] dispatched when a [ModalSubmitInteraction] is created. */
 public sealed interface ModalSubmitInteractionCreateEvent : ActionInteractionCreateEvent {
     override val interaction: ModalSubmitInteraction
 }
 
-/** An [Event] that fires when a [GuildModalSubmitInteraction] is created. */
+/** The [Event] dispatched when a [GuildModalSubmitInteraction] is created. */
 public class GuildModalSubmitInteractionCreateEvent(
     override val interaction: GuildModalSubmitInteraction,
     override val kord: Kord,
@@ -19,7 +19,7 @@ public class GuildModalSubmitInteractionCreateEvent(
     override val customContext: Any?,
 ) : ModalSubmitInteractionCreateEvent
 
-/** An [Event] that fires when a [GlobalModalSubmitInteraction] is created. */
+/** The [Event] dispatched when a [GlobalModalSubmitInteraction] is created. */
 public class GlobalModalSubmitInteractionCreateEvent(
     override val interaction: GlobalModalSubmitInteraction,
     override val shard: Int,
diff --git a/core/src/commonMain/kotlin/event/message/MessageBulkDeleteEvent.kt b/core/src/commonMain/kotlin/event/message/MessageBulkDeleteEvent.kt
index e907b884cf4e..425416729dc5 100644
--- a/core/src/commonMain/kotlin/event/message/MessageBulkDeleteEvent.kt
+++ b/core/src/commonMain/kotlin/event/message/MessageBulkDeleteEvent.kt
@@ -1,6 +1,7 @@
 package dev.kord.core.event.message
 
 import dev.kord.common.entity.Snowflake
+import dev.kord.common.exception.RequestException
 import dev.kord.core.Kord
 import dev.kord.core.behavior.GuildBehavior
 import dev.kord.core.behavior.channel.MessageChannelBehavior
@@ -9,11 +10,22 @@ import dev.kord.core.entity.Message
 import dev.kord.core.entity.Strategizable
 import dev.kord.core.entity.channel.MessageChannel
 import dev.kord.core.event.Event
+import dev.kord.core.exception.EntityNotFoundException
 import dev.kord.core.supplier.EntitySupplier
 import dev.kord.core.supplier.EntitySupplyStrategy
 import dev.kord.core.supplier.getChannelOf
 import dev.kord.core.supplier.getChannelOfOrNull
 
+/**
+ * The event dispatched when messages are deleted in bulk from a channel.
+ *
+ * See [Message bulk delete event](https://discord.com/developers/docs/resources/channel#bulk-delete-messages)
+ *
+ * @param messageIds The [Set] of message Ids to delete
+ * @param messages The [Set] of messages to delete as [Message]s
+ * @param channelId The channel to delete them from.
+ * @param guildId The guild the event occurred in
+ */
 public class MessageBulkDeleteEvent(
     public val messageIds: Set<Snowflake>,
     public val messages: Set<Message>,
@@ -24,15 +36,38 @@ public class MessageBulkDeleteEvent(
     override val customContext: Any?,
     override val supplier: EntitySupplier = kord.defaultSupplier,
 ) : Event, Strategizable {
-
+    /**
+     * The [MessageChannelBehavior] of the channel that triggered this event.
+     */
     public val channel: MessageChannelBehavior get() = MessageChannelBehavior(channelId, kord)
 
+    /**
+     * The [GuildBehavior] that triggered this event
+     */
     public val guild: GuildBehavior? get() = guildId?.let { GuildBehavior(it, kord) }
 
+    /**
+     * Requests to get the channel triggering the event as a [MessageChannel]
+     *
+     * @throws [RequestException] if anything went wrong during the request.
+     * @throws [EntityNotFoundException] if the [MessageChannel] wasn't present.
+     */
     public suspend fun getChannel(): MessageChannel = supplier.getChannelOf(channelId)
 
+    /**
+     * Requests to get the channel triggering the event as a [MessageChannel].
+     * Returns `null` if the channel is not present
+     *
+     * @throws [RequestException] if anything went wrong during the request.
+     */
     public suspend fun getChannelOrNull(): MessageChannel? = supplier.getChannelOfOrNull(channelId)
 
+    /**
+     * Requests to get the channel triggering the event.
+     * Returns `null` if the guild is not present
+     *
+     * @throws [RequestException] if anything went wrong during the request.
+     */
     public suspend fun getGuildOrNull(): Guild? = guildId?.let { supplier.getGuildOrNull(it) }
 
     override fun withStrategy(strategy: EntitySupplyStrategy<*>): MessageBulkDeleteEvent =
diff --git a/core/src/commonMain/kotlin/event/message/MessageCreateEvent.kt b/core/src/commonMain/kotlin/event/message/MessageCreateEvent.kt
index f56f643a4e23..1b7de44f4f96 100644
--- a/core/src/commonMain/kotlin/event/message/MessageCreateEvent.kt
+++ b/core/src/commonMain/kotlin/event/message/MessageCreateEvent.kt
@@ -12,6 +12,15 @@ import dev.kord.core.event.Event
 import dev.kord.core.supplier.EntitySupplier
 import dev.kord.core.supplier.EntitySupplyStrategy
 
+/**
+ * The event dispatched when a [Message] is created.
+ *
+ * See [Message create event](https://discord.com/developers/docs/resources/channel#create-message)
+ *
+ * @param message The [Message] that triggered the event
+ * @param guildId The guild ID the event occurred in. It may be `null` if the id was not stored in the cache
+ * @param member The member that was triggered in the event. It may be `null` if the member was not stored in the cache
+ */
 public class MessageCreateEvent(
     public val message: Message,
     public val guildId: Snowflake?,
diff --git a/core/src/commonMain/kotlin/event/message/MessageDeleteEvent.kt b/core/src/commonMain/kotlin/event/message/MessageDeleteEvent.kt
index 2502428c44a2..1fdbf3dbfbca 100644
--- a/core/src/commonMain/kotlin/event/message/MessageDeleteEvent.kt
+++ b/core/src/commonMain/kotlin/event/message/MessageDeleteEvent.kt
@@ -1,19 +1,32 @@
 package dev.kord.core.event.message
 
 import dev.kord.common.entity.Snowflake
+import dev.kord.common.exception.RequestException
 import dev.kord.core.Kord
 import dev.kord.core.behavior.GuildBehavior
 import dev.kord.core.behavior.channel.MessageChannelBehavior
 import dev.kord.core.entity.Guild
 import dev.kord.core.entity.Message
 import dev.kord.core.entity.Strategizable
+import dev.kord.core.entity.channel.DmChannel
 import dev.kord.core.entity.channel.MessageChannel
 import dev.kord.core.event.Event
+import dev.kord.core.exception.EntityNotFoundException
 import dev.kord.core.supplier.EntitySupplier
 import dev.kord.core.supplier.EntitySupplyStrategy
 import dev.kord.core.supplier.getChannelOf
 import dev.kord.core.supplier.getChannelOfOrNull
 
+/**
+ * The event dispatched when a message is deleted.
+ *
+ * See [Message delete](https://discord.com/developers/docs/resources/channel#delete-message)
+ *
+ * @param messageId The ID of the message that triggered the event
+ * @param channelId The ID of the channel that triggered the event
+ * @param guildId The ID of the guild that triggered the event. It may be `null` if the message was not stored in the cache
+ * @param message The message that triggered the event. It may be `null` if the message was not stored in the cache
+ */
 public class MessageDeleteEvent(
     public val messageId: Snowflake,
     public val channelId: Snowflake,
@@ -24,15 +37,38 @@ public class MessageDeleteEvent(
     override val customContext: Any?,
     override val supplier: EntitySupplier = kord.defaultSupplier,
 ) : Event, Strategizable {
-
+    /**
+     * The [MessageChannelBehavior] that triggered the event.
+     */
     public val channel: MessageChannelBehavior get() = MessageChannelBehavior(channelId, kord)
 
+    /**
+     * The [GuildBehavior] that triggered the event
+     */
     public val guild: GuildBehavior? get() = guildId?.let { GuildBehavior(it, kord) }
 
+    /**
+     * Requests to get the channel triggering the event as a [MessageChannel]
+     *
+     * @throws [RequestException] if anything went wrong during the request.
+     * @throws [EntityNotFoundException] if the [MessageChannel] wasn't present.
+     */
     public suspend fun getChannel(): MessageChannel = supplier.getChannelOf(channelId)
 
+    /**
+     * Requests to get the channel this message was delete from, if it was deleted in one,
+     * returns `null` if the [MessageChannel] isn't present.
+     *
+     * @throws [RequestException] if anything went wrong during the request.
+     */
     public suspend fun getChannelOrNull(): MessageChannel? = supplier.getChannelOfOrNull(channelId)
 
+    /**
+     * Requests to get the guild this message was created in, if it was created in one,
+     * returns null if the [Guild] isn't present or the message was a [DM][DmChannel].
+     *
+     * @throws [RequestException] if anything went wrong during the request.
+     */
     public suspend fun getGuildOrNull(): Guild? = guildId?.let { supplier.getGuildOrNull(it) }
 
     override fun withStrategy(strategy: EntitySupplyStrategy<*>): MessageDeleteEvent =
diff --git a/core/src/commonMain/kotlin/event/message/MessageUpdateEvent.kt b/core/src/commonMain/kotlin/event/message/MessageUpdateEvent.kt
index a6a90138e858..520775830920 100644
--- a/core/src/commonMain/kotlin/event/message/MessageUpdateEvent.kt
+++ b/core/src/commonMain/kotlin/event/message/MessageUpdateEvent.kt
@@ -2,15 +2,28 @@ package dev.kord.core.event.message
 
 import dev.kord.common.entity.DiscordPartialMessage
 import dev.kord.common.entity.Snowflake
+import dev.kord.common.exception.RequestException
 import dev.kord.core.Kord
 import dev.kord.core.behavior.MessageBehavior
 import dev.kord.core.behavior.channel.MessageChannelBehavior
 import dev.kord.core.entity.Message
 import dev.kord.core.entity.Strategizable
+import dev.kord.core.entity.channel.MessageChannel
 import dev.kord.core.event.Event
+import dev.kord.core.exception.EntityNotFoundException
 import dev.kord.core.supplier.EntitySupplier
 import dev.kord.core.supplier.EntitySupplyStrategy
 
+/**
+ * The event dispatched when a message is updated.
+ *
+ * See [Message update event](https://discord.com/developers/docs/resources/channel#edit-message)
+ *
+ * @param messageId The ID of the message that triggered the event
+ * @param channelId The ID of the channel that the event occurred in
+ * @param new The new message
+ * @param old The old [Message]. May be `null` if the old message was not stored in the cache
+ */
 public class MessageUpdateEvent(
     public val messageId: Snowflake,
     public val channelId: Snowflake,
@@ -32,9 +45,20 @@ public class MessageUpdateEvent(
      */
     public val channel: MessageChannelBehavior get() = MessageChannelBehavior(id = channelId, kord = kord)
 
-
+    /**
+     * Requests to get the message triggering the event as a [Message]
+     *
+     * @throws [RequestException] if anything went wrong during the request.
+     * @throws [EntityNotFoundException] if the [Message] wasn't present.
+     */
     public suspend fun getMessage(): Message = supplier.getMessage(channelId = channelId, messageId = messageId)
 
+    /**
+     * Requests to get the message triggering the event as a [Message].
+     * Returns `null` if the [Message] wasn't present.
+     *
+     * @throws [RequestException] if anything went wrong during the request.
+     */
     public suspend fun getMessageOrNull(): Message? = supplier.getMessageOrNull(channelId = channelId, messageId = messageId)
 
     override fun withStrategy(strategy: EntitySupplyStrategy<*>): MessageUpdateEvent =
diff --git a/core/src/commonMain/kotlin/event/message/ReactionAddEvent.kt b/core/src/commonMain/kotlin/event/message/ReactionAddEvent.kt
index 69dc6f2fc9ab..d3efccefd060 100644
--- a/core/src/commonMain/kotlin/event/message/ReactionAddEvent.kt
+++ b/core/src/commonMain/kotlin/event/message/ReactionAddEvent.kt
@@ -1,6 +1,7 @@
 package dev.kord.core.event.message
 
 import dev.kord.common.entity.Snowflake
+import dev.kord.common.exception.RequestException
 import dev.kord.core.Kord
 import dev.kord.core.behavior.GuildBehavior
 import dev.kord.core.behavior.MemberBehavior
@@ -10,11 +11,24 @@ import dev.kord.core.behavior.channel.MessageChannelBehavior
 import dev.kord.core.entity.*
 import dev.kord.core.entity.channel.MessageChannel
 import dev.kord.core.event.Event
+import dev.kord.core.exception.EntityNotFoundException
 import dev.kord.core.supplier.EntitySupplier
 import dev.kord.core.supplier.EntitySupplyStrategy
 import dev.kord.core.supplier.getChannelOf
 import dev.kord.core.supplier.getChannelOfOrNull
 
+/**
+ * The event triggered when a reaction is added to a message.
+ *
+ * See [Reaction Add event](https://discord.com/developers/docs/topics/gateway-events#message-reaction-add)
+ *
+ * @param userId The ID of the user that added the reaction
+ * @param channelId The ID of the channel the reaction was added in
+ * @param messageId The ID of the message the event happen on
+ * @param guildId The ID of the guild the event occurred on. It may be `null` if it was not stored in the cache
+ * @param emoji The [ReactionEmoji] added to the [message]
+ * @param messageAuthorId The ID of the user who authored the message that was reacted too.
+ */
 public class ReactionAddEvent(
     public val userId: Snowflake,
     public val channelId: Snowflake,
@@ -27,17 +41,39 @@ public class ReactionAddEvent(
     override val customContext: Any?,
     override val supplier: EntitySupplier = kord.defaultSupplier,
 ) : Event, Strategizable {
-
+    /**
+     * The [MessageChannelBehavior] that triggered the event
+     */
     public val channel: MessageChannelBehavior get() = MessageChannelBehavior(channelId, kord)
 
+    /**
+     * The [GuildBehavior] that triggered the event
+     */
     public val guild: GuildBehavior? get() = guildId?.let { GuildBehavior(it, kord) }
 
+    /**
+     * The [MessageBehavior] that triggered the event
+     */
     public val message: MessageBehavior get() = MessageBehavior(channelId, messageId, kord)
 
+    /**
+     * The [UserBehavior] that triggered the event
+     */
     public val user: UserBehavior get() = UserBehavior(userId, kord)
+
+    /**
+     * The user as a [MemberBehavior] that triggered the event
+     */
     public val userAsMember: MemberBehavior? get() = guildId?.let { MemberBehavior(it, userId, kord) }
 
+    /**
+     * The original message author as a [UserBehavior] who's message was reacted too.
+     */
     public val messageAuthor: UserBehavior? get() = messageAuthorId?.let { UserBehavior(it, kord) }
+
+    /**
+     * The [original message author][messageAuthor] as a [Member][MemberBehavior].
+     */
     public val messageAuthorAsMember: MemberBehavior?
         get() = guildId?.let { guildId ->
             messageAuthorId?.let { messageAuthorId ->
@@ -45,20 +81,82 @@ public class ReactionAddEvent(
             }
         }
 
+    /**
+     * Requests to get the channel triggering the event as a [MessageChannel]
+     *
+     * @throws [RequestException] if anything went wrong during the request.
+     * @throws [EntityNotFoundException] if the [MessageChannel] wasn't present.
+     */
     public suspend fun getChannel(): MessageChannel = supplier.getChannelOf(channelId)
 
+    /**
+     * Requests to get the channel triggering the event as a [MessageChannel].
+     * Returns `null` if the [MessageChannel] wasn't present.
+     *
+     * @throws [RequestException] if anything went wrong during the request.
+     */
     public suspend fun getChannelOrNull(): MessageChannel? = supplier.getChannelOfOrNull(channelId)
 
+    /**
+     * Requests to get the guild triggering the event as a [Guild].
+     * Returns `null` if the [Guild] wasn't present.
+     *
+     * @throws [RequestException] if anything went wrong during the request.
+     */
     public suspend fun getGuildOrNull(): Guild? = guildId?.let { supplier.getGuildOrNull(it) }
 
+    /**
+     * Requests to get the message triggering the event as a [Message]
+     *
+     * @throws [RequestException] if anything went wrong during the request.
+     * @throws [EntityNotFoundException] if the [Message] wasn't present.
+     */
     public suspend fun getMessage(): Message = supplier.getMessage(channelId = channelId, messageId = messageId)
+
+    /**
+     * Requests to get the message triggering the event as a [Message].
+     * Returns `null` if the [Message] wasn't present.
+     *
+     * @throws [RequestException] if anything went wrong during the request.
+     */
     public suspend fun getMessageOrNull(): Message? = supplier.getMessageOrNull(channelId = channelId, messageId = messageId)
 
+    /**
+     * Requests to get the user triggering the event as a [User]
+     *
+     * @throws [RequestException] if anything went wrong during the request.
+     * @throws [EntityNotFoundException] if the [User] wasn't present.
+     */
     public suspend fun getUser(): User = supplier.getUser(userId)
+
+    /**
+     * Requests to get the user triggering the event as a [User]
+     * Returns `null` if the [User] wasn't present.
+     *
+     * @throws [RequestException] if anything went wrong during the request.
+     */
     public suspend fun getUserOrNull(): User? = supplier.getUserOrNull(userId)
+
+    /**
+     * Requests to get the user triggering the event as a [Member]
+     *
+     * @throws [RequestException] if anything went wrong during the request.
+     * @throws [EntityNotFoundException] if the [Member] wasn't present.
+     */
     public suspend fun getUserAsMember(): Member? = guildId?.let { supplier.getMemberOrNull(it, userId) }
 
+    /**
+     * Requests to get the message author as a [User]
+     *
+     * @throws [RequestException] if anything went wrong during the request
+     */
     public suspend fun getMessageAuthorOrNull(): User? = messageAuthorId?.let { supplier.getUserOrNull(it) }
+
+    /**
+     * Requests to get the message author as a [Member]
+     *
+     * @throws [RequestException] if anything went wrong during the request
+     */
     public suspend fun getMessageAuthorAsMemberOrNull(): Member? = guildId?.let { guildId ->
         messageAuthorId?.let { messageAuthorId ->
             supplier.getMemberOrNull(guildId, messageAuthorId)
diff --git a/core/src/commonMain/kotlin/event/message/ReactionRemoveAllEvent.kt b/core/src/commonMain/kotlin/event/message/ReactionRemoveAllEvent.kt
index 9a8fe76dee63..f86cf5468b49 100644
--- a/core/src/commonMain/kotlin/event/message/ReactionRemoveAllEvent.kt
+++ b/core/src/commonMain/kotlin/event/message/ReactionRemoveAllEvent.kt
@@ -1,6 +1,7 @@
 package dev.kord.core.event.message
 
 import dev.kord.common.entity.Snowflake
+import dev.kord.common.exception.RequestException
 import dev.kord.core.Kord
 import dev.kord.core.behavior.GuildBehavior
 import dev.kord.core.behavior.MessageBehavior
@@ -10,11 +11,21 @@ import dev.kord.core.entity.Message
 import dev.kord.core.entity.Strategizable
 import dev.kord.core.entity.channel.MessageChannel
 import dev.kord.core.event.Event
+import dev.kord.core.exception.EntityNotFoundException
 import dev.kord.core.supplier.EntitySupplier
 import dev.kord.core.supplier.EntitySupplyStrategy
 import dev.kord.core.supplier.getChannelOf
 import dev.kord.core.supplier.getChannelOfOrNull
 
+/**
+ * The event dispatched when all the reactions are removed from a message
+ *
+ * See [Reaction remove all](https://discord.com/developers/docs/topics/gateway-events#message-reaction-remove-all)
+ *
+ * @param channelId The ID of the channel that triggered the event
+ * @param messageId The ID of the message that triggered the event
+ * @param guildId The ID of the guild that triggered the event, or `null` if it was not stored in the cache
+ */
 public class ReactionRemoveAllEvent(
     public val channelId: Snowflake,
     public val messageId: Snowflake,
@@ -24,19 +35,59 @@ public class ReactionRemoveAllEvent(
     override val customContext: Any?,
     override val supplier: EntitySupplier = kord.defaultSupplier,
 ) : Event, Strategizable {
-
+    /**
+     * The [MessageChannelBehavior] that triggered the event
+     */
     public val channel: MessageChannelBehavior get() = MessageChannelBehavior(channelId, kord)
 
+    /**
+     * The [GuildBehavior] that triggered the event
+     */
     public val guild: GuildBehavior? get() = guildId?.let { GuildBehavior(it, kord) }
 
+    /**
+     * The [MessageBehavior] that triggered the event
+     */
     public val message: MessageBehavior get() = MessageBehavior(channelId, messageId, kord)
 
+    /**
+     * Requests to get the channel triggering the event as a [MessageChannel]
+     *
+     * @throws [RequestException] if anything went wrong during the request.
+     * @throws [EntityNotFoundException] if the [MessageChannel] wasn't present.
+     */
     public suspend fun getChannel(): MessageChannel = supplier.getChannelOf(channelId)
+
+    /**
+     * Requests to get the channel triggering the event as a [MessageChannel].
+     * Returns `null` if the [MessageChannel] wasn't present.
+     *
+     * @throws [RequestException] if anything went wrong during the request.
+     */
     public suspend fun getChannelOrNull(): MessageChannel? = supplier.getChannelOfOrNull(channelId)
 
+    /**
+     * Requests to get the guild triggering the event as a [Guild].
+     * Returns `null` if the [Guild] wasn't present.
+     *
+     * @throws [RequestException] if anything went wrong during the request.
+     */
     public suspend fun getGuildOrNull(): Guild? = guildId?.let { supplier.getGuildOrNull(it) }
 
+    /**
+     * Requests to get the message triggering the event as a [Message]
+     *
+     * @throws [RequestException] if anything went wrong during the request.
+     * @throws [EntityNotFoundException] if the [Message] wasn't present.
+     */
     public suspend fun getMessage(): Message = supplier.getMessage(channelId = channelId, messageId = messageId)
+
+    /**
+     * Requests to get the message triggering the event as a [Message].
+     * Returns `null` if the [Message] wasn't present.
+     *
+     * @throws [RequestException] if anything went wrong during the request.
+     */
     public suspend fun getMessageOrNull(): Message? = supplier.getMessageOrNull(channelId = channelId, messageId = messageId)
 
     override fun withStrategy(strategy: EntitySupplyStrategy<*>): ReactionRemoveAllEvent =
diff --git a/core/src/commonMain/kotlin/event/message/ReactionRemoveEmojiEvent.kt b/core/src/commonMain/kotlin/event/message/ReactionRemoveEmojiEvent.kt
index 9397b45fa6b9..10d441871076 100644
--- a/core/src/commonMain/kotlin/event/message/ReactionRemoveEmojiEvent.kt
+++ b/core/src/commonMain/kotlin/event/message/ReactionRemoveEmojiEvent.kt
@@ -1,6 +1,7 @@
 package dev.kord.core.event.message
 
 import dev.kord.common.entity.Snowflake
+import dev.kord.common.exception.RequestException
 import dev.kord.core.Kord
 import dev.kord.core.behavior.GuildBehavior
 import dev.kord.core.behavior.MessageBehavior
@@ -12,11 +13,19 @@ import dev.kord.core.entity.ReactionEmoji
 import dev.kord.core.entity.Strategizable
 import dev.kord.core.entity.channel.TopGuildMessageChannel
 import dev.kord.core.event.Event
+import dev.kord.core.exception.EntityNotFoundException
 import dev.kord.core.supplier.EntitySupplier
 import dev.kord.core.supplier.EntitySupplyStrategy
 import dev.kord.core.supplier.getChannelOf
 import dev.kord.core.supplier.getChannelOfOrNull
 
+/**
+ * The event triggered when all instances reaction are removed.
+ *
+ * See [Reaction remove event](https://discord.com/developers/docs/topics/gateway-events#message-reaction-remove-emoji)
+ *
+ * @param data The data from the event
+ */
 public class ReactionRemoveEmojiEvent(
     public val data: ReactionRemoveEmojiData,
     override val kord: Kord,
@@ -30,6 +39,9 @@ public class ReactionRemoveEmojiEvent(
      */
     public val channelId: Snowflake get() = data.channelId
 
+    /**
+     * The [GuildMessageChannelBehavior] that triggered the event.
+     */
     public val channel: GuildMessageChannelBehavior
         get() = GuildMessageChannelBehavior(
             guildId = guildId,
@@ -38,34 +50,76 @@ public class ReactionRemoveEmojiEvent(
         )
 
     /**
-     * The id of the [Guild].
+     * The ID of the [Guild] that triggered the event.
      */
     public val guildId: Snowflake get() = data.guildId
 
+    /**
+     * The [GuildBehavior] that triggered the event.
+     */
     public val guild: GuildBehavior get() = GuildBehavior(id = guildId, kord = kord)
 
     /**
-     * The id of the message.
+     * The ID of the message that triggered the event.
      */
     public val messageId: Snowflake get() = data.messageId
 
+    /**
+     * The [MessageBehavior] that triggered the event.
+     */
     public val message: MessageBehavior get() = MessageBehavior(channelId = channelId, messageId = messageId, kord = kord)
 
     /**
-     * The emoji that was removed.
+     * The emoji that was removed in the event.
      */
     public val emoji: ReactionEmoji get() = ReactionEmoji.from(data.emoji)
 
+    /**
+     * Requests to get the channel triggering the event as a [TopGuildMessageChannel]
+     *
+     * @throws [RequestException] if anything went wrong during the request.
+     * @throws [EntityNotFoundException] if the [TopGuildMessageChannel] wasn't present.
+     */
     public suspend fun getChannel(): TopGuildMessageChannel = supplier.getChannelOf(channelId)
 
+    /**
+     * Requests to get the channel triggering the event as a [TopGuildMessageChannel].
+     * Returns `null` if the [TopGuildMessageChannel] wasn't present.
+     *
+     * @throws [RequestException] if anything went wrong during the request.
+     */
     public suspend fun getChannelOrNull(): TopGuildMessageChannel? = supplier.getChannelOfOrNull(channelId)
 
+    /**
+     * Requests to get the guild triggering the event as a [Guild]
+     *
+     * @throws [RequestException] if anything went wrong during the request.
+     * @throws [EntityNotFoundException] if the [Guild] wasn't present.
+     */
     public suspend fun getGuild(): Guild = supplier.getGuild(guildId)
 
+    /**
+     * Requests to get the guild triggering the event as a [Guild].
+     * Returns `null` if the [Guild] wasn't present.
+     *
+     * @throws [RequestException] if anything went wrong during the request.
+     */
     public suspend fun getGuildOrNull(): Guild? = supplier.getGuildOrNull(guildId)
 
+    /**
+     * Requests to get the message triggering the event as a [Message]
+     *
+     * @throws [RequestException] if anything went wrong during the request.
+     * @throws [EntityNotFoundException] if the [Message] wasn't present.
+     */
     public suspend fun getMessage(): Message = supplier.getMessage(channelId = channelId, messageId = messageId)
 
+    /**
+     * Requests to get the message triggering the event as a [Message].
+     * Returns `null` if the [Message] wasn't present.
+     *
+     * @throws [RequestException] if anything went wrong during the request.
+     */
     public suspend fun getMessageOrNull(): Message? = supplier.getMessageOrNull(channelId = channelId, messageId = messageId)
 
     override fun withStrategy(strategy: EntitySupplyStrategy<*>): ReactionRemoveEmojiEvent =
diff --git a/core/src/commonMain/kotlin/event/message/ReactionRemoveEvent.kt b/core/src/commonMain/kotlin/event/message/ReactionRemoveEvent.kt
index ed92d0e2da0c..de4b8da89c12 100644
--- a/core/src/commonMain/kotlin/event/message/ReactionRemoveEvent.kt
+++ b/core/src/commonMain/kotlin/event/message/ReactionRemoveEvent.kt
@@ -1,6 +1,7 @@
 package dev.kord.core.event.message
 
 import dev.kord.common.entity.Snowflake
+import dev.kord.common.exception.RequestException
 import dev.kord.core.Kord
 import dev.kord.core.behavior.GuildBehavior
 import dev.kord.core.behavior.MemberBehavior
@@ -9,12 +10,25 @@ import dev.kord.core.behavior.UserBehavior
 import dev.kord.core.behavior.channel.MessageChannelBehavior
 import dev.kord.core.entity.*
 import dev.kord.core.entity.channel.MessageChannel
+import dev.kord.core.entity.channel.TopGuildMessageChannel
 import dev.kord.core.event.Event
+import dev.kord.core.exception.EntityNotFoundException
 import dev.kord.core.supplier.EntitySupplier
 import dev.kord.core.supplier.EntitySupplyStrategy
 import dev.kord.core.supplier.getChannelOf
 import dev.kord.core.supplier.getChannelOfOrNull
 
+/**
+ * The event dispatched when a reaction is removed from a message.
+ *
+ * See [Reaction remove event](https://discord.com/developers/docs/topics/gateway-events#message-reaction-remove)
+ *
+ * @param userId The ID of the user that triggered the event
+ * @param channelId THe ID of the channel that triggered the event
+ * @param messageId The ID of the message that triggered the event
+ * @param guildId The ID of the guild that triggered the event. It may be `null` if it was not stored in the cache
+ * @param emoji The emoji removed from the message
+ */
 public class ReactionRemoveEvent(
     public val userId: Snowflake,
     public val channelId: Snowflake,
@@ -26,31 +40,93 @@ public class ReactionRemoveEvent(
     override val customContext: Any?,
     override val supplier: EntitySupplier = kord.defaultSupplier,
 ) : Event, Strategizable {
-
+    /**
+     * The [MessageChannelBehavior] that triggered the event
+     */
     public val channel: MessageChannelBehavior get() = MessageChannelBehavior(channelId, kord)
 
+    /**
+     * The [GuildBehavior] that triggered the event
+     */
     public val guild: GuildBehavior? get() = guildId?.let { GuildBehavior(it, kord) }
 
+    /**
+     * The [MessageBehavior] that triggered the event
+     */
     public val message: MessageBehavior get() = MessageBehavior(channelId, messageId, kord)
 
+    /**
+     * The [UserBehavior] that triggered the event
+     */
     public val user: UserBehavior get() = UserBehavior(userId, kord)
 
+    /**
+     * The [MemberBehavior] that triggered the event
+     */
     public val userAsMember: MemberBehavior? get() = guildId?.let { MemberBehavior(it, userId, kord) }
 
+    /**
+     * Requests to get the channel triggering the event as a [MessageChannel]
+     *
+     * @throws [RequestException] if anything went wrong during the request.
+     * @throws [EntityNotFoundException] if the [MessageChannel] wasn't present.
+     */
     public suspend fun getChannel(): MessageChannel = supplier.getChannelOf(channelId)
 
+    /**
+     * Requests to get the channel triggering the event as a [MessageChannel].
+     * Returns `null` if the [MessageChannel] wasn't present.
+     *
+     * @throws [RequestException] if anything went wrong during the request.
+     */
     public suspend fun getChannelOrNull(): MessageChannel? = supplier.getChannelOfOrNull(channelId)
 
+    /**
+     * Requests to get the guild triggering the event as a [Guild].
+     * Returns `null` if the [Guild] wasn't present.
+     *
+     * @throws [RequestException] if anything went wrong during the request.
+     */
     public suspend fun getGuildOrNull(): Guild? = guildId?.let { supplier.getGuildOrNull(it) }
 
+    /**
+     * Requests to get the message triggering the event as a [Message]
+     *
+     * @throws [RequestException] if anything went wrong during the request.
+     * @throws [EntityNotFoundException] if the [Message] wasn't present.
+     */
     public suspend fun getMessage(): Message = supplier.getMessage(channelId = channelId, messageId = messageId)
 
+    /**
+     * Requests to get the message triggering the event as a [Message].
+     * Returns `null` if the [Message] wasn't present.
+     *
+     * @throws [RequestException] if anything went wrong during the request.
+     */
     public suspend fun getMessageOrNull(): Message? = supplier.getMessageOrNull(channelId = channelId, messageId = messageId)
 
+    /**
+     * Requests to get the user triggering the event as a [User]
+     *
+     * @throws [RequestException] if anything went wrong during the request.
+     * @throws [EntityNotFoundException] if the [User] wasn't present.
+     */
     public suspend fun getUser(): User = supplier.getUser(userId)
 
+    /**
+     * Requests to get the user triggering the event as a [User].
+     * Returns `null` if the [TopGuildMessageChannel] wasn't present.
+     *
+     * @throws [RequestException] if anything went wrong during the request.
+     */
     public suspend fun getUserOrNull(): User? = supplier.getUserOrNull(userId)
 
+    /**
+     * Requests to get the user triggering the event as a [Member].
+     * Returns `null` if the [TopGuildMessageChannel] wasn't present.
+     *
+     * @throws [RequestException] if anything went wrong during the request.
+     */
     public suspend fun getUserAsMember(): Member? =
         guildId?.let { supplier.getMemberOrNull(guildId = guildId, userId = userId) }
 
diff --git a/core/src/commonMain/kotlin/event/role/RoleCreateEvent.kt b/core/src/commonMain/kotlin/event/role/RoleCreateEvent.kt
index 62512d1104ca..1fcae3aa7027 100644
--- a/core/src/commonMain/kotlin/event/role/RoleCreateEvent.kt
+++ b/core/src/commonMain/kotlin/event/role/RoleCreateEvent.kt
@@ -1,15 +1,24 @@
 package dev.kord.core.event.role
 
 import dev.kord.common.entity.Snowflake
+import dev.kord.common.exception.RequestException
 import dev.kord.core.Kord
 import dev.kord.core.behavior.GuildBehavior
 import dev.kord.core.entity.Guild
 import dev.kord.core.entity.Role
 import dev.kord.core.entity.Strategizable
 import dev.kord.core.event.Event
+import dev.kord.core.exception.EntityNotFoundException
 import dev.kord.core.supplier.EntitySupplier
 import dev.kord.core.supplier.EntitySupplyStrategy
 
+/**
+ * The event dispatched when a [Role] is created.
+ *
+ * See [Guild Role Create Event](https://discord.com/developers/docs/topics/gateway-events#guild-role-create)
+ *
+ * @param role The created [Role] that triggered the event
+ */
 public class RoleCreateEvent(
     public val role: Role,
     override val shard: Int,
@@ -19,12 +28,30 @@ public class RoleCreateEvent(
 
     override val kord: Kord get() = role.kord
 
+    /**
+     * The ID of the guild that triggered the event.
+     */
     public val guildId: Snowflake get() = role.guildId
 
+    /**
+     * The [GuildBehavior] tht triggered the event
+     */
     public val guild: GuildBehavior get() = GuildBehavior(guildId, kord)
 
+    /**
+     * Requests to get the guild triggering the event as a [Guild].
+     *
+     * @throws [RequestException] if anything went wrong during the request.
+     * @throws [EntityNotFoundException] if the guild is `null`
+     */
     public suspend fun getGuild(): Guild = supplier.getGuild(guildId)
 
+    /**
+     * Requests to get the guild triggering the event as a [Guild].
+     * Returns `null` if the [Guild] wasn't present.
+     *
+     * @throws [RequestException] if anything went wrong during the request.
+     */
     public suspend fun getGuildOrNull(): Guild? = supplier.getGuildOrNull(guildId)
 
     override fun withStrategy(strategy: EntitySupplyStrategy<*>): RoleCreateEvent =
diff --git a/core/src/commonMain/kotlin/event/role/RoleDeleteEvent.kt b/core/src/commonMain/kotlin/event/role/RoleDeleteEvent.kt
index 86811766a653..1de200815185 100644
--- a/core/src/commonMain/kotlin/event/role/RoleDeleteEvent.kt
+++ b/core/src/commonMain/kotlin/event/role/RoleDeleteEvent.kt
@@ -1,15 +1,26 @@
 package dev.kord.core.event.role
 
 import dev.kord.common.entity.Snowflake
+import dev.kord.common.exception.RequestException
 import dev.kord.core.Kord
 import dev.kord.core.behavior.GuildBehavior
 import dev.kord.core.entity.Guild
 import dev.kord.core.entity.Role
 import dev.kord.core.entity.Strategizable
 import dev.kord.core.event.Event
+import dev.kord.core.exception.EntityNotFoundException
 import dev.kord.core.supplier.EntitySupplier
 import dev.kord.core.supplier.EntitySupplyStrategy
 
+/**
+ * The event dispatched when a [Role] is deleted.
+ *
+ * See [Guild Role Delete Event](https://discord.com/developers/docs/topics/gateway-events#guild-role-delete)
+ *
+ * @param guildId The ID of the guild that triggered the event
+ * @param roleId The ID of the role that triggered the event
+ * @param role The [Role] that triggered the event. It may be `null` if it was not stored in the cache
+ */
 public class RoleDeleteEvent(
     public val guildId: Snowflake,
     public val roleId: Snowflake,
@@ -19,11 +30,25 @@ public class RoleDeleteEvent(
     override val customContext: Any?,
     override val supplier: EntitySupplier = kord.defaultSupplier,
 ) : Event, Strategizable {
-
+    /**
+     * The [GuildBehavior] that triggered the event.
+     */
     public val guild: GuildBehavior get() = GuildBehavior(guildId, kord)
 
+    /**
+     * Requests to get the guild triggering the event as a [Guild].
+     *
+     * @throws [RequestException] if anything went wrong during the request.
+     * @throws [EntityNotFoundException] if the guild is `null`
+     */
     public suspend fun getGuild(): Guild = supplier.getGuild(guildId)
 
+    /**
+     * Requests to get the guild triggering the event as a [Guild].
+     * Returns `null` if the [Guild] wasn't present.
+     *
+     * @throws [RequestException] if anything went wrong during the request.
+     */
     public suspend fun getGuildOrNull(): Guild? = supplier.getGuildOrNull(guildId)
 
     override fun withStrategy(strategy: EntitySupplyStrategy<*>): RoleDeleteEvent =
diff --git a/core/src/commonMain/kotlin/event/role/RoleUpdateEvent.kt b/core/src/commonMain/kotlin/event/role/RoleUpdateEvent.kt
index 75442611b24e..da04321edf35 100644
--- a/core/src/commonMain/kotlin/event/role/RoleUpdateEvent.kt
+++ b/core/src/commonMain/kotlin/event/role/RoleUpdateEvent.kt
@@ -1,15 +1,25 @@
 package dev.kord.core.event.role
 
 import dev.kord.common.entity.Snowflake
+import dev.kord.common.exception.RequestException
 import dev.kord.core.Kord
 import dev.kord.core.behavior.GuildBehavior
 import dev.kord.core.entity.Guild
 import dev.kord.core.entity.Role
 import dev.kord.core.entity.Strategizable
 import dev.kord.core.event.Event
+import dev.kord.core.exception.EntityNotFoundException
 import dev.kord.core.supplier.EntitySupplier
 import dev.kord.core.supplier.EntitySupplyStrategy
 
+/**
+ * The event dispatched when a [Role] is updated.
+ *
+ * See [Guild Role Update event](https://discord.com/developers/docs/topics/gateway-events#guild-role-update)
+ *
+ * @param role The updated [Role] that triggered the event.
+ * @param old The old [Role] that triggered the event. It may be `null` if it was not stored in the cache
+ */
 public class RoleUpdateEvent(
     public val role: Role,
     public val old: Role?,
@@ -20,12 +30,30 @@ public class RoleUpdateEvent(
 
     override val kord: Kord get() = role.kord
 
+    /**
+     * The ID of the guild that triggered the event.
+     */
     public val guildId: Snowflake get() = role.guildId
 
+    /**
+     * The [GuildBehavior] that triggered the event.
+     */
     public val guild: GuildBehavior get() = GuildBehavior(guildId, kord)
 
+    /**
+     * Requests to get the guild triggering the event as a [Guild].
+     *
+     * @throws [RequestException] if anything went wrong during the request.
+     * @throws [EntityNotFoundException] if the guild is `null`
+     */
     public suspend fun getGuild(): Guild = supplier.getGuild(guildId)
 
+    /**
+     * Requests to get the guild triggering the event as a [Guild].
+     * Returns `null` if the [Guild] wasn't present.
+     *
+     * @throws [RequestException] if anything went wrong during the request.
+     */
     public suspend fun getGuildOrNull(): Guild? = supplier.getGuildOrNull(guildId)
 
     override fun withStrategy(strategy: EntitySupplyStrategy<*>): RoleUpdateEvent =
diff --git a/core/src/commonMain/kotlin/event/user/PresenceUpdateEvent.kt b/core/src/commonMain/kotlin/event/user/PresenceUpdateEvent.kt
index 2ed362e9fb25..bdf98359abf6 100644
--- a/core/src/commonMain/kotlin/event/user/PresenceUpdateEvent.kt
+++ b/core/src/commonMain/kotlin/event/user/PresenceUpdateEvent.kt
@@ -12,6 +12,17 @@ import dev.kord.core.exception.EntityNotFoundException
 import dev.kord.core.supplier.EntitySupplier
 import dev.kord.core.supplier.EntitySupplyStrategy
 
+/**
+ * The event dispatched when a [Presence] is updated.
+ *
+ * See [Presence Update](https://discord.com/developers/docs/topics/gateway-events#guild-role-update)
+ *
+ * @param oldUser The old [User] that triggered the event. It may be `null` if it was not stored in the cache.
+ * @param user The [DiscordPresenceUser] that triggered the event.
+ * @param guildId The ID of the guild the event was triggered from.
+ * @param old The old [Presence] that triggered the event. It may be `null` if it was not stored in the cache.
+ * @param presence The new [Presence] that triggered the event.
+ */
 public class PresenceUpdateEvent(
     public val oldUser: User?,
     public val user: DiscordPresenceUser,
diff --git a/core/src/commonMain/kotlin/event/user/UserUpdateEvent.kt b/core/src/commonMain/kotlin/event/user/UserUpdateEvent.kt
index 84245d69d048..d10e471f8a45 100644
--- a/core/src/commonMain/kotlin/event/user/UserUpdateEvent.kt
+++ b/core/src/commonMain/kotlin/event/user/UserUpdateEvent.kt
@@ -4,6 +4,14 @@ import dev.kord.core.Kord
 import dev.kord.core.entity.User
 import dev.kord.core.event.Event
 
+/**
+ * The event dispatched when a [User] is updated.
+ *
+ * See [User update](https://discord.com/developers/docs/topics/gateway-events#user-update)
+ *
+ * @param old The old [User] that triggered the event. It may be `null` if it was not stored in the cache
+ * @param user The [User] that triggered the event.
+ */
 public class UserUpdateEvent(
     public val old: User?,
     public val user: User,
diff --git a/core/src/commonMain/kotlin/event/user/VoiceStateUpdateEvent.kt b/core/src/commonMain/kotlin/event/user/VoiceStateUpdateEvent.kt
index bae274ae00df..b645ebd6ebe2 100644
--- a/core/src/commonMain/kotlin/event/user/VoiceStateUpdateEvent.kt
+++ b/core/src/commonMain/kotlin/event/user/VoiceStateUpdateEvent.kt
@@ -4,6 +4,14 @@ import dev.kord.core.Kord
 import dev.kord.core.entity.VoiceState
 import dev.kord.core.event.Event
 
+/**
+ * The event dispatched when a [VoiceState] is updated.
+ *
+ * See [Voice State update](https://discord.com/developers/docs/topics/gateway-events#voice-state-update)
+ *
+ * @param old The old [VoiceState] that triggered the event. It may be `null` if it was not stored in the cache
+ * @param state The [VoiceState] that triggered the event.
+ */
 public class VoiceStateUpdateEvent(
     public val old: VoiceState?,
     public val state: VoiceState,
diff --git a/core/src/commonMain/kotlin/exception/EntityNotFoundException.kt b/core/src/commonMain/kotlin/exception/EntityNotFoundException.kt
index a145d0956a23..b10e6e5644a6 100644
--- a/core/src/commonMain/kotlin/exception/EntityNotFoundException.kt
+++ b/core/src/commonMain/kotlin/exception/EntityNotFoundException.kt
@@ -4,6 +4,9 @@ import dev.kord.common.entity.Snowflake
 import dev.kord.core.entity.application.ApplicationCommand
 import dev.kord.core.entity.channel.Channel
 
+/**
+ * Thrown when an Entity cannot be found.
+ */
 public class EntityNotFoundException : Exception {
 
     public constructor(message: String) : super(message)
@@ -13,45 +16,132 @@ public class EntityNotFoundException : Exception {
     @Suppress("NOTHING_TO_INLINE")
     public companion object {
 
+        /**
+         * Indicates an Entity cannot be found
+         *
+         * @param entityType The type of entity that cannot be found
+         * @param id The ID of the entity that was not found
+         * @throws EntityNotFoundException
+         */
         @PublishedApi
         internal inline fun entityNotFound(entityType: String, id: Snowflake): Nothing =
             throw EntityNotFoundException("$entityType with id $id was not found.")
 
+        /**
+         * Indicates a Guild Entity cannot be found
+         *
+         * @param entityType The type of entity that cannot be found
+         * @param guildId The ID of the guild that cannot be found
+         * @param id The ID of the entity that was not found
+         * @throws EntityNotFoundException
+         */
         @PublishedApi
         internal inline fun guildEntityNotFound(entityType: String, guildId: Snowflake, id: Snowflake): Nothing =
             throw EntityNotFoundException("$entityType with id $id in guild $guildId was not found.")
 
-
+        /**
+         * Indicates a guild was not found.
+         *
+         * @param guildId The ID of the guild that was not found
+         * @throws EntityNotFoundException
+         */
         public inline fun guildNotFound(guildId: Snowflake): Nothing =
             entityNotFound("Guild", guildId)
 
+        /**
+         * Indicates a channel was not found.
+         *
+         * @param channelId The ID of the channel that was not found
+         * @throws EntityNotFoundException
+         */
         public inline fun <reified T : Channel> channelNotFound(channelId: Snowflake): Nothing =
             entityNotFound(T::class.simpleName!!, channelId)
 
+        /**
+         * Indicates a member was not found.
+         *
+         * @param guildId The ID of the guild
+         * @param userId The ID of the member that was not found
+         * @throws EntityNotFoundException
+         */
         public inline fun memberNotFound(guildId: Snowflake, userId: Snowflake): Nothing =
             guildEntityNotFound("Member", guildId = guildId, id = userId)
 
+        /**
+         * Indicates a message was not found.
+         *
+         * @param channelId The ID of the channel
+         * @param messageId The ID of the message that was not found
+         * @throws EntityNotFoundException
+         */
         public inline fun messageNotFound(channelId: Snowflake, messageId: Snowflake): Nothing =
             throw EntityNotFoundException("Message with id $messageId in channel $channelId was not found.")
 
+        /**
+         * Indicates a user was not found.
+         *
+         * @param userId The ID of the user that was not found
+         * @throws EntityNotFoundException
+         */
         public inline fun userNotFound(userId: Snowflake): Nothing =
             entityNotFound("User", userId)
 
+        /**
+         * Indicates the self user was not found.
+         *
+         * @throws EntityNotFoundException
+         */
         public inline fun selfNotFound(): Nothing =
             throw EntityNotFoundException("Self user was not found.")
 
+        /**
+         * Indicates a role was not found.
+         *
+         * @param guildId The ID of the guild
+         * @param roleId The ID of the role that was not found
+         * @throws EntityNotFoundException
+         */
         public inline fun roleNotFound(guildId: Snowflake, roleId: Snowflake): Nothing =
             guildEntityNotFound("Role", guildId = guildId, id = roleId)
 
+        /**
+         * Indicates a ban was not found.
+         *
+         * @param guildId The ID of the guild
+         * @param userId The ID of the user
+         * @throws EntityNotFoundException
+         */
         public inline fun banNotFound(guildId: Snowflake, userId: Snowflake): Nothing =
             guildEntityNotFound("Ban", guildId = guildId, id = userId)
 
+        /**
+         * Indicates an emoji was not found.
+         *
+         * @param guildId The ID of the guild
+         * @param emojiId The ID of the emoji that was not found
+         * @throws EntityNotFoundException
+         */
         public inline fun emojiNotFound(guildId: Snowflake, emojiId: Snowflake): Nothing =
             guildEntityNotFound("GuildEmoji", guildId = guildId, id = emojiId)
 
+        /**
+         * Indicates a webhook was not found.
+         *
+         * @param webhookId The ID of the webhook that was not found
+         * @throws EntityNotFoundException
+         */
         public inline fun webhookNotFound(webhookId: Snowflake): Nothing =
             entityNotFound("Webhook", webhookId)
 
+        /**
+         * Indicates a webhook was not found.
+         *
+         * @param webhookId The ID of the webhook that was not found
+         * @param token The token for the interaction
+         * @param messageId The ID of the message that was not found
+         * @param threadId The ID of the thread the webhook was not found in, or null if this is a channel
+         * @throws EntityNotFoundException
+         */
         public inline fun webhookMessageNotFound(
             webhookId: Snowflake,
             token: String,
@@ -63,45 +153,119 @@ public class EntityNotFoundException : Exception {
             }from webhook $webhookId with token $token was not found."
         )
 
+        /**
+         * Indicates an invite was not found.
+         *
+         * @param code The code of the invite that was not found
+         * @throws EntityNotFoundException
+         */
         public inline fun inviteNotFound(code: String): Nothing =
             throw EntityNotFoundException("Invite with code $code was not found.")
 
+        /**
+         * Indicates a widget was not found.
+         *
+         * @param id The ID of the widget that was not found
+         * @throws EntityNotFoundException
+         */
         public inline fun widgetNotFound(id: Snowflake): Nothing =
             throw EntityNotFoundException("Widget for guild ${id.value} was not found.")
 
+        /**
+         * Indicates a template was not found.
+         *
+         * @param code The code of the template that was not found
+         * @throws EntityNotFoundException
+         */
         public inline fun templateNotFound(code: String): Nothing =
             throw EntityNotFoundException("Template $code was not found.")
 
+        /**
+         * Indicates a welcome screen was not found.
+         *
+         * @param guildId The ID of the guild the screen was not found
+         * @throws EntityNotFoundException
+         */
         public inline fun welcomeScreenNotFound(guildId: Snowflake): Nothing =
             throw EntityNotFoundException("Welcome screen for guild $guildId was not found.")
 
         public inline fun onboardingNotFound(guildId: Snowflake): Nothing =
             throw EntityNotFoundException("Onboarding for guild $guildId was not found.")
 
+        /**
+         * Indicates a state instance was not found.
+         *
+         * @param channelId The ID of the channel that was not found
+         * @throws EntityNotFoundException
+         */
         public inline fun stageInstanceNotFound(channelId: Snowflake): Nothing =
             throw EntityNotFoundException("Stage instance for channel $channelId was not found.")
 
+        /**
+         * Indicates a sticker was not found.
+         *
+         * @param stickerId The ID of the sticker that was not found
+         * @throws EntityNotFoundException
+         */
         public inline fun stickerNotFound(stickerId: Snowflake): Nothing =
             entityNotFound("Sticker", stickerId)
 
+        /**
+         * Indicates an application command permission was not found.
+         *
+         * @param commandId The ID of the command that was not found
+         * @throws EntityNotFoundException
+         */
         public inline fun applicationCommandPermissionsNotFound(commandId: Snowflake): Nothing =
             entityNotFound("ApplicationCommand", commandId)
 
+        /**
+         * Indicates an event was not found.
+         *
+         * @param eventId The ID of the event that was not found
+         * @throws EntityNotFoundException
+         */
         public inline fun guildScheduledEventNotFound(eventId: Snowflake): Nothing =
             entityNotFound("GuildScheduledEvent", eventId)
 
+        /**
+         * Indicates a guild was not found.
+         *
+         * @param guildId The ID of the guild that was not found
+         * @throws EntityNotFoundException
+         */
         public inline fun <reified T : ApplicationCommand> applicationCommandNotFound(commandId: Snowflake): Nothing =
             entityNotFound(T::class.simpleName!!, commandId)
 
+        /**
+         * Indicates an interaction was not found.
+         *
+         * @param token The ID of the interaction that was not found
+         * @throws EntityNotFoundException
+         */
         public inline fun interactionNotFound(token: String): Nothing = throw EntityNotFoundException(
             "Initial interaction response for interaction with token $token was not found."
         )
 
+        /**
+         * Indicates a followup message was not found.
+         *
+         * @param token The ID of the interaction
+         * @param messageId The ID of the message that was not found
+         * @throws EntityNotFoundException
+         */
         public inline fun followupMessageNotFound(token: String, messageId: Snowflake): Nothing =
             throw EntityNotFoundException(
                 "Followup message with id $messageId for interaction with token $token was not found."
             )
 
+        /**
+         * Indicates an auto-moderation rule was not found.
+         *
+         * @param guildId The ID of the guild
+         * @param ruleId The ID rule that was not found
+         * @throws EntityNotFoundException
+         */
         public inline fun autoModerationRuleNotFound(guildId: Snowflake, ruleId: Snowflake): Nothing =
             guildEntityNotFound("Auto Moderation Rule", guildId, ruleId)
     }
diff --git a/core/src/commonMain/kotlin/exception/GatewayNotFoundException.kt b/core/src/commonMain/kotlin/exception/GatewayNotFoundException.kt
index c16592b1f470..c195e07aade4 100644
--- a/core/src/commonMain/kotlin/exception/GatewayNotFoundException.kt
+++ b/core/src/commonMain/kotlin/exception/GatewayNotFoundException.kt
@@ -2,6 +2,9 @@ package dev.kord.core.exception
 
 import dev.kord.common.entity.Snowflake
 
+/**
+ * Thrown when a Gateway cannot be found.
+ */
 public class GatewayNotFoundException : Exception {
     public constructor(message: String) : super(message)
     public constructor(cause: Throwable) : super(cause)
diff --git a/core/src/commonMain/kotlin/exception/KordInitializationException.kt b/core/src/commonMain/kotlin/exception/KordInitializationException.kt
index c6570a3723fa..729f526e77c3 100644
--- a/core/src/commonMain/kotlin/exception/KordInitializationException.kt
+++ b/core/src/commonMain/kotlin/exception/KordInitializationException.kt
@@ -1,5 +1,8 @@
 package dev.kord.core.exception
 
+/**
+ * Thrown when Kord cannot successfully initialize.
+ */
 public class KordInitializationException : Exception {
     public constructor(message: String) : super(message)
     public constructor(cause: Throwable) : super(cause)
diff --git a/core/src/commonMain/kotlin/gateway/DefaultMasterGateway.kt b/core/src/commonMain/kotlin/gateway/DefaultMasterGateway.kt
index 411c85afcb28..a031f41f8b75 100644
--- a/core/src/commonMain/kotlin/gateway/DefaultMasterGateway.kt
+++ b/core/src/commonMain/kotlin/gateway/DefaultMasterGateway.kt
@@ -7,16 +7,13 @@ import kotlinx.coroutines.flow.merge
 import kotlin.time.Duration
 import kotlin.time.Duration.Companion.microseconds
 
+/**
+ * The Default [MasterGateway] implementation.
+ */
 public class DefaultMasterGateway(
     override val gateways: Map<Int, Gateway>,
 ): MasterGateway {
 
-    /**
-     * Calculates the average [Gateway.ping] of all running [gateways].
-     *
-     * Gateways that return `null` are not counted into the average, if all [gateways]
-     * return `null` then this property will return `null` as well.
-     */
     override val averagePing: Duration?
         get(): Duration? {
             val pings = gateways.values.mapNotNull { it.ping.value?.inWholeMicroseconds }
diff --git a/core/src/commonMain/kotlin/gateway/MasterGateway.kt b/core/src/commonMain/kotlin/gateway/MasterGateway.kt
index 83ea47d33e5f..b2909e0031ea 100644
--- a/core/src/commonMain/kotlin/gateway/MasterGateway.kt
+++ b/core/src/commonMain/kotlin/gateway/MasterGateway.kt
@@ -8,9 +8,19 @@ import kotlin.contracts.InvocationKind.EXACTLY_ONCE
 import kotlin.contracts.contract
 import kotlin.time.Duration
 
+/**
+ * The event dispatched for a shard event.
+ *
+ * @property event The event that was sent
+ * @property gateway The [Gateway] the event was sent through
+ * @property shard The shard number that the event was sent through
+ */
 public data class ShardEvent(val event: Event, val gateway: Gateway, val shard: Int)
 
 public interface MasterGateway {
+    /**
+     * A [Map] of all [Gateway]s for the bot, identified by their [Int] value in map
+     */
     public val gateways: Map<Int, Gateway>
 
     /**
@@ -22,8 +32,16 @@ public interface MasterGateway {
     public val averagePing: Duration?
 
 
+    /**
+     * The [Flow] of [ShardEvent]s through the gateway.
+     */
     public val events: Flow<ShardEvent>
 
+    /**
+     * Starts the gateway with the desired [configuration][GatewayConfiguration].
+     *
+     * @param configuration The desired configuration to start the gateway with.
+     */
     public suspend fun startWithConfig(configuration: GatewayConfiguration): Unit = coroutineScope {
         gateways.entries.forEach { (shard, gateway) ->
             val config = configuration.copy(shard = configuration.shard.copy(index = shard))
@@ -33,13 +51,33 @@ public interface MasterGateway {
         }
     }
 
+    /**
+     * Sends a [command] to all [gateways], suspending until the message has been sent.
+     *
+     * @param command The [Command] to send to the gateway
+     * @throws Exception When the gateway isn't open
+     */
     public suspend fun sendAll(command: Command): Unit = gateways.values.forEach { it.send(command) }
 
+    /**
+     * Closes all gateways and releases all resources.
+     * **For some implementations this will render the Gateway unopenable,
+     * as such, all implementations should be handled as if they are irreversibly closed.**
+     */
     public suspend fun detachAll(): Unit = gateways.values.forEach { it.detach() }
 
+    /**
+     * Closes all Gateways and ends the current sessions, suspending until the underlying webSocket is closed.
+     */
     public suspend fun stopAll(): Unit = gateways.values.forEach { it.stop() }
 }
 
+/**
+ * Starts the gateway.
+ *
+ * @param token The Bot token
+ * @param config The configuration to start the gateway with
+ */
 public suspend inline fun MasterGateway.start(token: String, config: GatewayConfigurationBuilder.() -> Unit = {}) {
     contract { callsInPlace(config, EXACTLY_ONCE) }
 
diff --git a/core/src/commonMain/kotlin/live/LiveGuild.kt b/core/src/commonMain/kotlin/live/LiveGuild.kt
index c385c9542926..f12c02f6fa55 100644
--- a/core/src/commonMain/kotlin/live/LiveGuild.kt
+++ b/core/src/commonMain/kotlin/live/LiveGuild.kt
@@ -20,21 +20,46 @@ import dev.kord.core.event.user.VoiceStateUpdateEvent
 import dev.kord.core.live.exception.LiveCancellationException
 import kotlinx.coroutines.*
 
+/**
+ * Returns a [LiveGuild] for a given [Guild].
+ *
+ * @param coroutineScope The [CoroutineScope] to create the [LiveGuild] with
+ * @return the created [LiveGuild]
+ */
 @KordPreview
 public fun Guild.live(
     coroutineScope: CoroutineScope = kord + SupervisorJob(kord.coroutineContext.job)
 ): LiveGuild = LiveGuild(this, coroutineScope)
 
+/**
+ * Returns a [LiveGuild] for a given [Guild] with configuration.
+ *
+ * @param coroutineScope The [CoroutineScope] to create the [LiveGuild] with
+ * @param block The [LiveGuild] configuration
+ * @return the created [LiveGuild]
+ */
 @KordPreview
 public inline fun Guild.live(
     coroutineScope: CoroutineScope = kord + SupervisorJob(kord.coroutineContext.job),
     block: LiveGuild.() -> Unit
 ): LiveGuild = this.live(coroutineScope).apply(block)
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public fun LiveGuild.onEmojisUpdate(scope: CoroutineScope = this, block: suspend (EmojisUpdateEvent) -> Unit): Job =
     on(scope = scope, consumer = block)
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public fun LiveGuild.onIntegrationsUpdate(
     scope: CoroutineScope = this,
@@ -42,18 +67,42 @@ public fun LiveGuild.onIntegrationsUpdate(
 ): Job =
     on(scope = scope, consumer = block)
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public fun LiveGuild.onBanAdd(scope: CoroutineScope = this, block: suspend (BanAddEvent) -> Unit): Job =
     on(scope = scope, consumer = block)
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public fun LiveGuild.onBanRemove(scope: CoroutineScope = this, block: suspend (BanRemoveEvent) -> Unit): Job =
     on(scope = scope, consumer = block)
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public fun LiveGuild.onPresenceUpdate(scope: CoroutineScope = this, block: suspend (PresenceUpdateEvent) -> Unit): Job =
     on(scope = scope, consumer = block)
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public fun LiveGuild.onVoiceServerUpdate(
     scope: CoroutineScope = this,
@@ -61,6 +110,12 @@ public fun LiveGuild.onVoiceServerUpdate(
 ): Job =
     on(scope = scope, consumer = block)
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public fun LiveGuild.onVoiceStateUpdate(
     scope: CoroutineScope = this,
@@ -68,38 +123,93 @@ public fun LiveGuild.onVoiceStateUpdate(
 ): Job =
     on(scope = scope, consumer = block)
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public fun LiveGuild.onWebhookUpdate(scope: CoroutineScope = this, block: suspend (WebhookUpdateEvent) -> Unit): Job =
     on(scope = scope, consumer = block)
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public fun LiveGuild.onRoleCreate(scope: CoroutineScope = this, block: suspend (RoleCreateEvent) -> Unit): Job =
     on(scope = scope, consumer = block)
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public fun LiveGuild.onRoleUpdate(scope: CoroutineScope = this, block: suspend (RoleUpdateEvent) -> Unit): Job =
     on(scope = scope, consumer = block)
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public fun LiveGuild.onRoleDelete(scope: CoroutineScope = this, block: suspend (RoleDeleteEvent) -> Unit): Job =
     on(scope = scope, consumer = block)
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public fun LiveGuild.onMemberJoin(scope: CoroutineScope = this, block: suspend (MemberJoinEvent) -> Unit): Job =
     on(scope = scope, consumer = block)
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public fun LiveGuild.onMemberUpdate(scope: CoroutineScope = this, block: suspend (MemberUpdateEvent) -> Unit): Job =
     on(scope = scope, consumer = block)
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public fun LiveGuild.onMemberLeave(scope: CoroutineScope = this, block: suspend (MemberLeaveEvent) -> Unit): Job =
     on(scope = scope, consumer = block)
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public fun LiveGuild.onReactionAdd(scope: CoroutineScope = this, block: suspend (ReactionAddEvent) -> Unit): Job =
     on(scope = scope, consumer = block)
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param reaction The [ReactionEmoji] that was added
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public inline fun LiveGuild.onReactionAdd(
     reaction: ReactionEmoji,
@@ -110,10 +220,23 @@ public inline fun LiveGuild.onReactionAdd(
     }
 }
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public fun LiveGuild.onReactionRemove(scope: CoroutineScope = this, block: suspend (ReactionRemoveEvent) -> Unit): Job =
     on(scope = scope, consumer = block)
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param reaction The [ReactionEmoji] that was removed
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public inline fun LiveGuild.onReactionRemove(
     reaction: ReactionEmoji,
@@ -124,6 +247,12 @@ public inline fun LiveGuild.onReactionRemove(
     }
 }
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public fun LiveGuild.onReactionRemoveAll(
     scope: CoroutineScope = this,
@@ -131,38 +260,92 @@ public fun LiveGuild.onReactionRemoveAll(
 ): Job =
     on(scope = scope, consumer = block)
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public fun LiveGuild.onMessageCreate(scope: CoroutineScope = this, block: suspend (MessageCreateEvent) -> Unit): Job =
     on(scope = scope, consumer = block)
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public fun LiveGuild.onMessageUpdate(scope: CoroutineScope = this, block: suspend (MessageUpdateEvent) -> Unit): Job =
     on(scope = scope, consumer = block)
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public fun LiveGuild.onMessageDelete(scope: CoroutineScope = this, block: suspend (MessageDeleteEvent) -> Unit): Job =
     on(scope = scope, consumer = block)
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public fun LiveGuild.onChannelCreate(scope: CoroutineScope = this, block: suspend (ChannelCreateEvent) -> Unit): Job =
     on(scope = scope, consumer = block)
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public fun LiveGuild.onChannelUpdate(scope: CoroutineScope = this, block: suspend (ChannelUpdateEvent) -> Unit): Job =
     on(scope = scope, consumer = block)
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public fun LiveGuild.onChannelDelete(scope: CoroutineScope = this, block: suspend (ChannelDeleteEvent) -> Unit): Job =
     on(scope = scope, consumer = block)
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public fun LiveGuild.onGuildCreate(scope: CoroutineScope = this, block: suspend (GuildCreateEvent) -> Unit): Job =
     on(scope = scope, consumer = block)
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public fun LiveGuild.onGuildUpdate(scope: CoroutineScope = this, block: suspend (GuildUpdateEvent) -> Unit): Job =
     on(scope = scope, consumer = block)
 
+/**
+ * A [AbstractLiveKordEntity] for a [Guild]
+ *
+ * @property guild The [Guild] to get the live entity for
+ * @property coroutineContext The [CoroutineScope] to create the live object with
+ */
 @KordPreview
 public class LiveGuild(
     guild: Guild,
@@ -172,6 +355,9 @@ public class LiveGuild(
     override val id: Snowflake
         get() = guild.id
 
+    /**
+     * The [Guild] to create the live entity for
+     */
     public var guild: Guild = guild
         private set
 
diff --git a/core/src/commonMain/kotlin/live/LiveKordEntity.kt b/core/src/commonMain/kotlin/live/LiveKordEntity.kt
index f3920e19759d..111f34c7cf09 100644
--- a/core/src/commonMain/kotlin/live/LiveKordEntity.kt
+++ b/core/src/commonMain/kotlin/live/LiveKordEntity.kt
@@ -20,11 +20,22 @@ import kotlin.coroutines.CoroutineContext
  */
 @KordPreview
 public interface LiveKordEntity : KordEntity, CoroutineScope {
+    /**
+     * A [Flow] of [Event]s for this entity
+     */
     public val events: Flow<Event>
 
+    /**
+     * Shuts down a Live event with a cancellation exception.
+     *
+     * @param cause An optional cause to provide for the cancellation. Defaults to "The live entity is shut down"
+     */
     public fun shutDown(cause: CancellationException = CancellationException("The live entity is shut down", null))
 }
 
+/**
+ * An abstract [LiveKordEntity] with an attached [CoroutineScope`]
+ */
 @KordPreview
 public abstract class AbstractLiveKordEntity(
     final override val kord: Kord,
@@ -37,7 +48,16 @@ public abstract class AbstractLiveKordEntity(
     final override val events: SharedFlow<Event> =
         kord.events.filter { filter(it) }.onEach { update(it) }.shareIn(this, SharingStarted.Eagerly)
 
+    /**
+     * Filters for a specific [Event] that matches the [event].
+     *
+     * @return Whether the [Event] matches the [event] or not
+     */
     protected abstract fun filter(event: Event): Boolean
+
+    /**
+     * Updates an [Event]
+     */
     protected abstract fun update(event: Event)
 
     override fun shutDown(cause: CancellationException): Unit = cancel(cause)
diff --git a/core/src/commonMain/kotlin/live/LiveMember.kt b/core/src/commonMain/kotlin/live/LiveMember.kt
index 509d9a5dee42..dc2c3159414f 100644
--- a/core/src/commonMain/kotlin/live/LiveMember.kt
+++ b/core/src/commonMain/kotlin/live/LiveMember.kt
@@ -9,24 +9,50 @@ import dev.kord.core.event.guild.BanAddEvent
 import dev.kord.core.event.guild.GuildDeleteEvent
 import dev.kord.core.event.guild.MemberLeaveEvent
 import dev.kord.core.event.guild.MemberUpdateEvent
+import dev.kord.core.live.channel.LiveChannel
 import dev.kord.core.live.exception.LiveCancellationException
 import kotlinx.coroutines.*
 
+/**
+ * Returns a [LiveMember] for a given [Member].
+ *
+ * @param coroutineScope The [CoroutineScope] to create the [LiveChannel] with
+ * @return the created [LiveMember]
+ */
 @KordPreview
 public fun Member.live(
     coroutineScope: CoroutineScope = kord + SupervisorJob(kord.coroutineContext.job)
 ): LiveMember = LiveMember(this, coroutineScope)
 
+/**
+ * Returns a [LiveMember] for a given [Member] with configuration.
+ *
+ * @param coroutineScope The [CoroutineScope] to create the [LiveChannel] with
+ * @param block The [LiveMember] configuration
+ * @return the created [LiveMember]
+ */
 @KordPreview
 public inline fun Member.live(
     coroutineScope: CoroutineScope = kord + SupervisorJob(kord.coroutineContext.job),
     block: LiveMember.() -> Unit
 ): LiveMember = this.live(coroutineScope).apply(block)
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public fun LiveMember.onUpdate(scope: CoroutineScope = this, block: suspend (MemberUpdateEvent) -> Unit): Job =
     on(scope = scope, consumer = block)
 
+/**
+ * A [AbstractLiveKordEntity] for a [Member]
+ *
+ * @property member The [Member] to get the live entity for
+ * @property coroutineContext The [CoroutineScope] to create the live object with
+ */
 @KordPreview
 public class LiveMember(
     member: Member,
@@ -36,6 +62,9 @@ public class LiveMember(
     override val id: Snowflake
         get() = member.id
 
+    /**
+     * The [Member] to create the live entity for
+     */
     public var member: Member = member
         private set
 
diff --git a/core/src/commonMain/kotlin/live/LiveMessage.kt b/core/src/commonMain/kotlin/live/LiveMessage.kt
index f9cc36c1aaf6..3ecb9fff60d1 100644
--- a/core/src/commonMain/kotlin/live/LiveMessage.kt
+++ b/core/src/commonMain/kotlin/live/LiveMessage.kt
@@ -18,22 +18,48 @@ import dev.kord.core.live.exception.LiveCancellationException
 import dev.kord.core.supplier.EntitySupplyStrategy
 import kotlinx.coroutines.*
 
+/**
+ * Returns a [LiveMessage] for a given [Message].
+ *
+ * @param coroutineScope The [CoroutineScope] to create the [LiveMessage] with
+ * @return the created [LiveMessage]
+ */
 @KordPreview
 public suspend fun Message.live(
     coroutineScope: CoroutineScope = kord + SupervisorJob(kord.coroutineContext.job)
 ): LiveMessage =
     LiveMessage(this, withStrategy(EntitySupplyStrategy.cacheWithRestFallback).getGuildOrNull()?.id, coroutineScope)
 
+/**
+ * Returns a [LiveMessage] for a given [Message] with configuration.
+ *
+ * @param coroutineScope The [CoroutineScope] to create the [LiveMessage] with
+ * @param block The [LiveMessage] configuration
+ * @return the created [LiveMessage]
+ */
 @KordPreview
 public suspend fun Message.live(
     coroutineScope: CoroutineScope = kord + SupervisorJob(kord.coroutineContext.job),
     block: LiveMessage.() -> Unit
 ): LiveMessage = this.live(coroutineScope).apply(block)
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public fun LiveMessage.onReactionAdd(scope: CoroutineScope = this, block: suspend (ReactionAddEvent) -> Unit): Job =
     on(scope = scope, consumer = block)
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param reaction The [ReactionEmoji] that was added
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public inline fun LiveMessage.onReactionAdd(
     reaction: ReactionEmoji,
@@ -44,6 +70,12 @@ public inline fun LiveMessage.onReactionAdd(
     }
 }
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public fun LiveMessage.onReactionRemove(
     scope: CoroutineScope = this,
@@ -51,6 +83,13 @@ public fun LiveMessage.onReactionRemove(
 ): Job =
     on(scope = scope, consumer = block)
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param reaction The [ReactionEmoji] that was removed
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public inline fun LiveMessage.onReactionRemove(
     reaction: ReactionEmoji,
@@ -61,6 +100,12 @@ public inline fun LiveMessage.onReactionRemove(
     }
 }
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public fun LiveMessage.onReactionRemoveAll(
     scope: CoroutineScope = this,
@@ -68,10 +113,22 @@ public fun LiveMessage.onReactionRemoveAll(
 ): Job =
     on(scope = scope, consumer = block)
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public fun LiveMessage.onUpdate(scope: CoroutineScope = this, block: suspend (MessageUpdateEvent) -> Unit): Job =
     on(scope = scope, consumer = block)
 
+/**
+ * A [AbstractLiveKordEntity] for a [Message]
+ *
+ * @property message The [Message] to get the live entity for
+ * @property coroutineContext The [CoroutineScope] to create the live object with
+ */
 @KordPreview
 public class LiveMessage(
     message: Message,
@@ -82,6 +139,9 @@ public class LiveMessage(
     override val id: Snowflake
         get() = message.id
 
+    /**
+     * The [Message] to get the live entity for
+     */
     public var message: Message = message
         private set
 
diff --git a/core/src/commonMain/kotlin/live/LiveRole.kt b/core/src/commonMain/kotlin/live/LiveRole.kt
index a29a51503db3..4740ed641990 100644
--- a/core/src/commonMain/kotlin/live/LiveRole.kt
+++ b/core/src/commonMain/kotlin/live/LiveRole.kt
@@ -11,21 +11,46 @@ import dev.kord.core.event.role.RoleUpdateEvent
 import dev.kord.core.live.exception.LiveCancellationException
 import kotlinx.coroutines.*
 
+/**
+ * Returns a [LiveRole] for a given [Role].
+ *
+ * @param coroutineScope The [CoroutineScope] to create the [LiveRole] with
+ * @return the created [LiveRole]
+ */
 @KordPreview
 public fun Role.live(
     coroutineScope: CoroutineScope = kord + SupervisorJob(kord.coroutineContext.job)
 ): LiveRole = LiveRole(this, coroutineScope)
 
+/**
+ * Returns a [LiveRole] for a given [Role] with configuration.
+ *
+ * @param coroutineScope The [CoroutineScope] to create the [LiveRole] with
+ * @param block The [LiveRole] configuration
+ * @return the created [LiveRole]
+ */
 @KordPreview
 public inline fun Role.live(
     coroutineScope: CoroutineScope = kord + SupervisorJob(kord.coroutineContext.job),
     block: LiveRole.() -> Unit
 ): LiveRole = this.live(coroutineScope).apply(block)
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public fun LiveRole.onUpdate(scope: CoroutineScope = this, block: suspend (RoleUpdateEvent) -> Unit): Job =
     on(scope = scope, consumer = block)
 
+/**
+ * A [AbstractLiveKordEntity] for a [Role]
+ *
+ * @property role The [Role] to get the live entity for
+ * @property coroutineContext The [CoroutineScope] to create the live object with
+ */
 @KordPreview
 public class LiveRole(
     role: Role,
@@ -35,6 +60,9 @@ public class LiveRole(
     override val id: Snowflake
         get() = role.id
 
+    /**
+     * The [Role] to get the live entity for
+     */
     public var role: Role = role
         private set
 
diff --git a/core/src/commonMain/kotlin/live/LiveUser.kt b/core/src/commonMain/kotlin/live/LiveUser.kt
index be1120984891..8bc8680c8669 100644
--- a/core/src/commonMain/kotlin/live/LiveUser.kt
+++ b/core/src/commonMain/kotlin/live/LiveUser.kt
@@ -8,21 +8,46 @@ import dev.kord.core.event.Event
 import dev.kord.core.event.user.UserUpdateEvent
 import kotlinx.coroutines.*
 
+/**
+ * Returns a [LiveUser] for a given [User].
+ *
+ * @param coroutineScope The [CoroutineScope] to create the [LiveUser] with
+ * @return the created [LiveUser]
+ */
 @KordPreview
 public fun User.live(
     coroutineScope: CoroutineScope = kord + SupervisorJob(kord.coroutineContext.job)
 ): LiveUser = LiveUser(this, coroutineScope)
 
+/**
+ * Returns a [LiveUser] for a given [User] with configuration.
+ *
+ * @param coroutineScope The [CoroutineScope] to create the [LiveUser] with
+ * @param block The [LiveUser] configuration
+ * @return the created [LiveUser]
+ */
 @KordPreview
 public inline fun User.live(
     coroutineScope: CoroutineScope = kord + SupervisorJob(kord.coroutineContext.job),
     block: LiveUser.() -> Unit
 ): LiveUser = this.live(coroutineScope).apply(block)
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public fun LiveUser.onUpdate(scope: CoroutineScope = this, block: suspend (UserUpdateEvent) -> Unit): Job =
     on(scope = scope, consumer = block)
 
+/**
+ * A [AbstractLiveKordEntity] for a [User]
+ *
+ * @property user The [User] to get the live entity for
+ * @property coroutineContext The [CoroutineScope] to create the live object with
+ */
 @KordPreview
 public class LiveUser(
     user: User,
diff --git a/core/src/commonMain/kotlin/live/channel/LiveCategory.kt b/core/src/commonMain/kotlin/live/channel/LiveCategory.kt
index 8f1d07d0230c..59cc3358dbc1 100644
--- a/core/src/commonMain/kotlin/live/channel/LiveCategory.kt
+++ b/core/src/commonMain/kotlin/live/channel/LiveCategory.kt
@@ -13,21 +13,46 @@ import dev.kord.core.live.exception.LiveCancellationException
 import dev.kord.core.live.on
 import kotlinx.coroutines.*
 
+/**
+ * Returns a [LiveCategory] for the given [Category]
+ *
+ * @param coroutineScope The [CoroutineScope] to create the [LiveCategory] with
+ * @return The created [LiveCategory]
+ */
 @KordPreview
 public fun Category.live(
     coroutineScope: CoroutineScope = kord + SupervisorJob(kord.coroutineContext.job)
 ): LiveCategory = LiveCategory(this, coroutineScope)
 
+/**
+ * Returns a [LiveCategory] for a given [Category] with configuration.
+ *
+ * @param coroutineScope The [CoroutineScope] to create the [LiveCategory] with.
+ * @param block The [LiveCategory] configuration
+ * @return The created [LiveCategory]
+ */
 @KordPreview
 public inline fun Category.live(
     coroutineScope: CoroutineScope = kord + SupervisorJob(kord.coroutineContext.job),
     block: LiveCategory.() -> Unit
 ): LiveCategory = this.live(coroutineScope).apply(block)
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public fun LiveCategory.onUpdate(scope: CoroutineScope = this, block: suspend (CategoryUpdateEvent) -> Unit): Job =
     on(scope = scope, consumer = block)
 
+/**
+ * A Live entity for a [Category].
+ *
+ * @property channel The [Category] to get a live object for
+ * @property coroutineScope The [CoroutineScope] to create the live object with
+ */
 @KordPreview
 public class LiveCategory(
     channel: Category,
diff --git a/core/src/commonMain/kotlin/live/channel/LiveChannel.kt b/core/src/commonMain/kotlin/live/channel/LiveChannel.kt
index 8cad10cde0ed..7b0978f8f9fa 100644
--- a/core/src/commonMain/kotlin/live/channel/LiveChannel.kt
+++ b/core/src/commonMain/kotlin/live/channel/LiveChannel.kt
@@ -17,6 +17,12 @@ import dev.kord.core.live.AbstractLiveKordEntity
 import dev.kord.core.live.on
 import kotlinx.coroutines.*
 
+/**
+ * Returns a [LiveChannel] for a given [Channel].
+ *
+ * @param coroutineScope The [CoroutineScope] to create the [LiveChannel] with
+ * @return the created [LiveChannel]
+ */
 @KordPreview
 public fun Channel.live(
     coroutineScope: CoroutineScope = kord + SupervisorJob(kord.coroutineContext.job)
@@ -28,20 +34,46 @@ public fun Channel.live(
     else -> error("unsupported channel type")
 }
 
+/**
+ * Returns a [LiveChannel] for a given [Channel] with configuration.
+ *
+ * @param coroutineScope The [CoroutineScope] to create the [LiveChannel] with
+ * @param block The [LiveChannel] configuration
+ * @return the created [LiveChannel]
+ */
 @KordPreview
 public inline fun Channel.live(
     coroutineScope: CoroutineScope = kord + SupervisorJob(kord.coroutineContext.job),
     block: LiveChannel.() -> Unit
 ): LiveChannel = this.live(coroutineScope).apply(block)
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public fun LiveChannel.onVoiceStateUpdate(scope: CoroutineScope = this, block: suspend (VoiceStateUpdateEvent) -> Unit): Job =
     on(scope = scope, consumer = block)
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public fun LiveChannel.onReactionAdd(scope: CoroutineScope = this, block: suspend (ReactionAddEvent) -> Unit): Job =
     on(scope = scope, consumer = block)
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param reaction The [ReactionEmoji] that was added
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public inline fun LiveChannel.onReactionAdd(
     reaction: ReactionEmoji,
@@ -53,10 +85,23 @@ public inline fun LiveChannel.onReactionAdd(
     }
 }
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public fun LiveChannel.onReactionRemove(scope: CoroutineScope = this, block: suspend (ReactionRemoveEvent) -> Unit): Job =
     on(scope = scope, consumer = block)
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param reaction The [ReactionEmoji] that was removed
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public inline fun LiveChannel.onReactionRemove(
     reaction: ReactionEmoji,
@@ -68,36 +113,81 @@ public inline fun LiveChannel.onReactionRemove(
     }
 }
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public fun LiveChannel.onReactionRemoveAll(scope: CoroutineScope = this, block: suspend (ReactionRemoveAllEvent) -> Unit): Job =
     on(scope = scope, consumer = block)
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public fun LiveChannel.onMessageCreate(scope: CoroutineScope = this, block: suspend (MessageCreateEvent) -> Unit): Job =
     on(scope = scope, consumer = block)
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public fun LiveChannel.onMessageUpdate(scope: CoroutineScope = this, block: suspend (MessageUpdateEvent) -> Unit): Job =
     on(scope = scope, consumer = block)
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public fun LiveChannel.onMessageDelete(scope: CoroutineScope = this, block: suspend (MessageDeleteEvent) -> Unit): Job =
     on(scope = scope, consumer = block)
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public fun LiveChannel.onChannelUpdate(scope: CoroutineScope = this, block: suspend (ChannelUpdateEvent) -> Unit): Job =
     on(scope = scope, consumer = block)
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public fun LiveChannel.onGuildUpdate(scope: CoroutineScope = this, block: suspend (GuildUpdateEvent) -> Unit): Job =
     on(scope = scope, consumer = block)
 
+/**
+ * A [AbstractLiveKordEntity] for a [Channel]
+ *
+ * @property kord The [Kord] instance for the channel
+ * @property coroutineContext The [CoroutineScope] to create the live object with
+ */
 @KordPreview
 public abstract class LiveChannel(
     kord: Kord,
     coroutineScope: CoroutineScope = kord + SupervisorJob(kord.coroutineContext.job)
 ) : AbstractLiveKordEntity(kord, coroutineScope) {
 
+    /**
+     * The [Channel] to get a live object for.
+     */
     public abstract val channel: Channel
 
     override fun filter(event: Event): Boolean = when (event) {
diff --git a/core/src/commonMain/kotlin/live/channel/LiveDmChannel.kt b/core/src/commonMain/kotlin/live/channel/LiveDmChannel.kt
index 2c4c2d1dbb30..95384f463fe6 100644
--- a/core/src/commonMain/kotlin/live/channel/LiveDmChannel.kt
+++ b/core/src/commonMain/kotlin/live/channel/LiveDmChannel.kt
@@ -13,21 +13,46 @@ import dev.kord.core.live.exception.LiveCancellationException
 import dev.kord.core.live.on
 import kotlinx.coroutines.*
 
+/**
+ * Returns a [LiveDmChannel] for a given [DmChannel].
+ *
+ * @param coroutineScope The [CoroutineScope] to create the [LiveDmChannel] with
+ * @return the created [LiveDmChannel]
+ */
 @KordPreview
 public fun DmChannel.live(
     coroutineScope: CoroutineScope = kord + SupervisorJob(kord.coroutineContext.job)
 ): LiveDmChannel = LiveDmChannel(this, coroutineScope)
 
+/**
+ * Returns a [LiveDmChannel] for a given [DmChannel] with configuration.
+ *
+ * @param coroutineScope The [CoroutineScope] to create the [LiveDmChannel] with
+ * @param block The [LiveDmChannel] configuration
+ * @return the created [LiveDmChannel]
+ */
 @KordPreview
 public inline fun DmChannel.live(
     coroutineScope: CoroutineScope = kord + SupervisorJob(kord.coroutineContext.job),
     block: LiveDmChannel.() -> Unit
 ): LiveDmChannel = this.live(coroutineScope).apply(block)
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public fun LiveDmChannel.onUpdate(scope: CoroutineScope = this, block: suspend (DMChannelUpdateEvent) -> Unit): Job =
     on(scope = scope, consumer = block)
 
+/**
+ * A live entity for a [DmChannel]
+ *
+ * @property channel The [DmChannel] to get a live object for
+ * @property coroutineScope The [CoroutineScope] to create the [LiveChannel] with
+ */
 @KordPreview
 public class LiveDmChannel(
     channel: DmChannel,
diff --git a/core/src/commonMain/kotlin/live/channel/LiveGuildChannel.kt b/core/src/commonMain/kotlin/live/channel/LiveGuildChannel.kt
index 0debeedb99e1..3210fc3ea08a 100644
--- a/core/src/commonMain/kotlin/live/channel/LiveGuildChannel.kt
+++ b/core/src/commonMain/kotlin/live/channel/LiveGuildChannel.kt
@@ -14,21 +14,46 @@ import dev.kord.core.live.exception.LiveCancellationException
 import dev.kord.core.live.on
 import kotlinx.coroutines.*
 
+/**
+ * Returns a [LiveGuildChannel] for a given [TopGuildChannel].
+ *
+ * @param coroutineScope The [CoroutineScope] to create the [LiveGuildChannel] with
+ * @return the created [LiveGuildChannel]
+ */
 @KordPreview
 public fun TopGuildChannel.live(
     coroutineScope: CoroutineScope = kord + SupervisorJob(kord.coroutineContext.job)
 ): LiveGuildChannel = LiveGuildChannel(this, coroutineScope)
 
+/**
+ * Returns a [LiveGuildChannel] for a given [TopGuildChannel] with configuration.
+ *
+ * @param coroutineScope The [CoroutineScope] to create the [LiveGuildChannel] with
+ * @param block The [LiveGuildChannel] configuration
+ * @return the created [LiveGuildChannel]
+ */
 @KordPreview
 public inline fun TopGuildChannel.live(
     coroutineScope: CoroutineScope = kord + SupervisorJob(kord.coroutineContext.job),
     block: LiveGuildChannel.() -> Unit
 ): LiveGuildChannel = this.live(coroutineScope).apply(block)
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public fun LiveGuildChannel.onUpdate(scope: CoroutineScope = this, block: suspend (ChannelUpdateEvent) -> Unit): Job =
     on(scope = scope, consumer = block)
 
+/**
+ * A live entity for a [TopGuildChannel]
+ *
+ * @property channel The [TopGuildChannel] to get a live object for
+ * @property coroutineScope The [CoroutineScope] to create the [LiveChannel] with
+ */
 @KordPreview
 public class LiveGuildChannel(
     channel: TopGuildChannel,
diff --git a/core/src/commonMain/kotlin/live/channel/LiveGuildMessageChannel.kt b/core/src/commonMain/kotlin/live/channel/LiveGuildMessageChannel.kt
index aee65818aa9c..9451749cac56 100644
--- a/core/src/commonMain/kotlin/live/channel/LiveGuildMessageChannel.kt
+++ b/core/src/commonMain/kotlin/live/channel/LiveGuildMessageChannel.kt
@@ -3,6 +3,7 @@ package dev.kord.core.live.channel
 import dev.kord.common.annotation.KordPreview
 import dev.kord.common.entity.Snowflake
 import dev.kord.core.entity.KordEntity
+import dev.kord.core.entity.channel.TopGuildChannel
 import dev.kord.core.entity.channel.TopGuildMessageChannel
 import dev.kord.core.event.Event
 import dev.kord.core.event.channel.ChannelCreateEvent
@@ -13,21 +14,46 @@ import dev.kord.core.live.exception.LiveCancellationException
 import dev.kord.core.live.on
 import kotlinx.coroutines.*
 
+/**
+ * Returns a [LiveGuildMessageChannel] for a given [TopGuildMessageChannel].
+ *
+ * @param coroutineScope The [CoroutineScope] to create the [LiveGuildMessageChannel] with
+ * @return the created [LiveGuildMessageChannel]
+ */
 @KordPreview
 public fun TopGuildMessageChannel.live(
     coroutineScope: CoroutineScope = kord + SupervisorJob(kord.coroutineContext.job)
 ): LiveGuildMessageChannel = LiveGuildMessageChannel(this, coroutineScope)
 
+/**
+ * Returns a [LiveGuildMessageChannel] for a given [TopGuildMessageChannel] with configuration.
+ *
+ * @param coroutineScope The [CoroutineScope] to create the [LiveGuildMessageChannel] with
+ * @param block The [LiveGuildMessageChannel] configuration
+ * @return the created [LiveGuildMessageChannel]
+ */
 @KordPreview
 public inline fun TopGuildMessageChannel.live(
     coroutineScope: CoroutineScope = kord + SupervisorJob(kord.coroutineContext.job),
     block: LiveGuildMessageChannel.() -> Unit
 ): LiveGuildMessageChannel = this.live(coroutineScope).apply(block)
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public fun LiveGuildMessageChannel.onUpdate(scope: CoroutineScope = this, block: suspend (ChannelUpdateEvent) -> Unit): Job =
     on(scope = scope, consumer = block)
 
+/**
+ * A live entity for a [TopGuildMessageChannel]
+ *
+ * @property channel The [TopGuildChannel] to get a live object for
+ * @property coroutineScope The [CoroutineScope] to create the [LiveChannel] with
+ */
 @KordPreview
 public class LiveGuildMessageChannel(
     channel: TopGuildMessageChannel,
diff --git a/core/src/commonMain/kotlin/live/channel/LiveVoiceChannel.kt b/core/src/commonMain/kotlin/live/channel/LiveVoiceChannel.kt
index bf9a333994b6..a9b89300c999 100644
--- a/core/src/commonMain/kotlin/live/channel/LiveVoiceChannel.kt
+++ b/core/src/commonMain/kotlin/live/channel/LiveVoiceChannel.kt
@@ -13,17 +13,36 @@ import dev.kord.core.live.exception.LiveCancellationException
 import dev.kord.core.live.on
 import kotlinx.coroutines.*
 
+/**
+ * Returns a [LiveVoiceChannel] for a given [VoiceChannel].
+ *
+ * @param coroutineScope The [CoroutineScope] to create the [LiveChannel] with
+ * @return the created [LiveVoiceChannel]
+ */
 @KordPreview
 public fun VoiceChannel.live(
     coroutineScope: CoroutineScope = kord + SupervisorJob(kord.coroutineContext.job)
 ): LiveVoiceChannel = LiveVoiceChannel(this, coroutineScope)
 
+/**
+ * Returns a [LiveVoiceChannel] for a given [VoiceChannel] with configuration.
+ *
+ * @param coroutineScope The [CoroutineScope] to create the [LiveChannel] with
+ * @param block The [LiveVoiceChannel] configuration
+ * @return the created [LiveVoiceChannel]
+ */
 @KordPreview
 public inline fun VoiceChannel.live(
     coroutineScope: CoroutineScope = kord + SupervisorJob(kord.coroutineContext.job),
     block: LiveVoiceChannel.() -> Unit
 ): LiveVoiceChannel = this.live(coroutineScope).apply(block)
 
+/**
+ * Invokes the consumer for this entity with [block] for the given [CoroutineScope]
+ *
+ * @param scope The [CoroutineScope] to invoke the consumer with
+ * @param block The configuration for the consumer
+ */
 @KordPreview
 public fun LiveVoiceChannel.onUpdate(
     scope: CoroutineScope = this,
@@ -31,6 +50,12 @@ public fun LiveVoiceChannel.onUpdate(
 ): Job =
     on(scope = scope, consumer = block)
 
+/**
+ * A live entity for a [VoiceChannel]
+ *
+ * @property channel The [VoiceChannel] to get a live object for
+ * @property coroutineScope The [CoroutineScope] to create the [LiveChannel] with
+ */
 @KordPreview
 public class LiveVoiceChannel(
     channel: VoiceChannel,
diff --git a/core/src/commonMain/kotlin/live/exception/LiveCancellationException.kt b/core/src/commonMain/kotlin/live/exception/LiveCancellationException.kt
index 986a58ed7780..37cc572d1a66 100644
--- a/core/src/commonMain/kotlin/live/exception/LiveCancellationException.kt
+++ b/core/src/commonMain/kotlin/live/exception/LiveCancellationException.kt
@@ -3,5 +3,10 @@ package dev.kord.core.live.exception
 import dev.kord.core.event.Event
 import kotlinx.coroutines.CancellationException
 
+/**
+ * Thrown when a Live Event was cancelled.
+ *
+ * @property message The detail message
+ */
 public class LiveCancellationException(public val event: Event, message: String? = null) :
     CancellationException(message)
diff --git a/core/src/commonMain/kotlin/supplier/CacheEntitySupplier.kt b/core/src/commonMain/kotlin/supplier/CacheEntitySupplier.kt
index 6f782fd40cce..8e99f8f13346 100644
--- a/core/src/commonMain/kotlin/supplier/CacheEntitySupplier.kt
+++ b/core/src/commonMain/kotlin/supplier/CacheEntitySupplier.kt
@@ -98,6 +98,9 @@ public class CacheEntitySupplier(private val kord: Kord) : EntitySupplier {
             Member(it, userData, kord)
         }
 
+    /**
+     *  fetches all cached [Role]s
+     */
     public suspend fun getRole(id: Snowflake): Role? {
         val data = cache.query { idEq(RoleData::id, id) }.singleOrNull() ?: return null
 
diff --git a/core/src/commonMain/kotlin/supplier/EntitySupplier.kt b/core/src/commonMain/kotlin/supplier/EntitySupplier.kt
index 153ad6190d75..50c556e146c1 100644
--- a/core/src/commonMain/kotlin/supplier/EntitySupplier.kt
+++ b/core/src/commonMain/kotlin/supplier/EntitySupplier.kt
@@ -437,7 +437,7 @@ public interface EntitySupplier {
 
     /**
      * Requests the [Template] with the given [code].
-     * returns null when the webhook isn't present.
+     * returns null when the template isn't present.
      *
      * @throws RequestException if something went wrong while retrieving the template.
      * @throws EntityNotFoundException if template was null.
@@ -445,43 +445,141 @@ public interface EntitySupplier {
     public suspend fun getTemplate(code: String): Template =
         getTemplateOrNull(code) ?: EntityNotFoundException.templateNotFound(code)
 
+    /**
+     * Requests the templates for a guild
+     *
+     * @param guildId The ID of the guild to get the templates from
+     * @return a [Flow] of [Template]s for the given [guildId].
+     * @throws RequestException if something went wrong while retrieving the templates
+     */
     public fun getTemplates(guildId: Snowflake): Flow<Template>
 
+    /**
+     * Requests the [StageInstance]s for a channel.
+     * returns `null` when the instance is not present
+     *
+     * @param channelId The ID of the channel to get the instance for
+     * @return a nullable [StageInstance] for the given [channelId]
+     * @throws RequestException if something went wrong during the request
+     */
     public suspend fun getStageInstanceOrNull(channelId: Snowflake): StageInstance?
 
+    /**
+     * Requests the [StageInstance]s for a channel.
+     *
+     * @param channelId The ID of the channel to get the instance for
+     * @return a [StageInstance] for the given [channelId].
+     * @throws RequestException if something went wrong during the request
+     * @throws EntityNotFoundException if the state instance was null
+     */
     public suspend fun getStageInstance(channelId: Snowflake): StageInstance =
         getStageInstanceOrNull(channelId) ?: EntityNotFoundException.stageInstanceNotFound(channelId)
 
+    /**
+     * Requests the [ThreadMember]s for a thread channel.
+     *
+     * @param channelId The ID of the thread channel to get the members for
+     * @return a [Flow] of [ThreadMember]s for the given [channelId].
+     * @throws RequestException if something went wrong during the request
+     * @throws EntityNotFoundException if the thread members was null
+     */
     public fun getThreadMembers(channelId: Snowflake): Flow<ThreadMember>
 
+    /**
+     * Requests the [ThreadChannel]s that are active for a guild.
+     *
+     * @param guildId The ID of the guild to get the thread channels for
+     * @return a [Flow] of [ThreadChannel]s for the given [guildId].
+     * @throws RequestException if something went wrong during the request
+     * @throws EntityNotFoundException if the active threads was null
+     */
     public fun getActiveThreads(guildId: Snowflake): Flow<ThreadChannel>
 
+    /**
+     * Requests the public [ThreadChannel]s that are archived for a guild.
+     *
+     * @param channelId The ID of the channel to get the public archived thread channels for
+     * @param before The [Instant] to look before
+     * @param limit The limit on the number of [ThreadChannel]s to collect for the flow
+     * @return a [Flow] of [ThreadChannel]s for the given [channelId].
+     * @throws RequestException if something went wrong during the request
+     * @throws EntityNotFoundException if the active threads was null
+     */
     public fun getPublicArchivedThreads(
         channelId: Snowflake,
         before: Instant? = null,
         limit: Int? = null,
     ): Flow<ThreadChannel>
 
+    /**
+     * Requests the private [ThreadChannel]s that are archived for a guild.
+     *
+     * @param channelId The ID of the channel to get the private archived thread channels for
+     * @param before The [Instant] to look before
+     * @param limit The limit on the number of [ThreadChannel]s to collect for the flow
+     * @return a [Flow] of [ThreadChannel]s for the given [channelId].
+     * @throws RequestException if something went wrong during the request
+     * @throws EntityNotFoundException if the active threads was null
+     */
     public fun getPrivateArchivedThreads(
         channelId: Snowflake,
         before: Instant? = null,
         limit: Int? = null,
     ): Flow<ThreadChannel>
 
+    /**
+     * Requests the joined private [ThreadChannel]s that are archived for a guild.
+     *
+     * @param channelId The ID of the channel to get the joined private archived thread channels for
+     * @param before The [Instant] to look before
+     * @param limit The limit on the number of [ThreadChannel]s to collect for the flow
+     * @return a [Flow] of [ThreadChannel]s for the given [channelId].
+     * @throws RequestException if something went wrong during the request
+     * @throws EntityNotFoundException if the active threads was null
+     */
     public fun getJoinedPrivateArchivedThreads(
         channelId: Snowflake,
         before: Snowflake? = null,
         limit: Int? = null,
     ): Flow<ThreadChannel>
 
+    /**
+     * Gets the [GuildApplicationCommand]s for a given [guildId].
+     *
+     * @param applicationId The application to get the commands for
+     * @param guildId The ID of the guild to get the commands for
+     * @param withLocalizations Whether to get the commands with localizations or not. Defaults to `null`
+     * @return a [Flow] of [GuildApplicationCommand]s for the given [guildId].
+     * @throws RequestException if something went wrong during the request
+     * @throws EntityNotFoundException if the flow was null
+     */
     public fun getGuildApplicationCommands(applicationId: Snowflake, guildId: Snowflake, withLocalizations: Boolean? = null): Flow<GuildApplicationCommand>
 
+    /**
+     * Gets a [GuildApplicationCommand] based on the [guildId] and [commandId].
+     * returns `null` if the command was not found
+     *
+     * @param guildId The ID of the guild to get the command from
+     * @param commandId The ID of the command to get
+     * @return The [GuildApplicationCommand] or `null` if it was not found.
+     * @throws RequestException if something went wrong during the request
+     */
     public suspend fun getGuildApplicationCommandOrNull(
         applicationId: Snowflake,
         guildId: Snowflake,
         commandId: Snowflake
     ): GuildApplicationCommand?
 
+    /**
+     * Gets a [GuildApplicationCommand] for a given [guildId] and [commandId].
+     *
+     * @param applicationId The application to get the command for
+     * @param guildId The ID of the guild to get the command for
+     * @param commandId The ID of the command
+     * @return a [GuildApplicationCommand] for the given [commandId].
+     * @throws RequestException if something went wrong during the request
+     * @throws EntityNotFoundException if the flow was null
+     */
     public suspend fun getGuildApplicationCommand(
         applicationId: Snowflake,
         guildId: Snowflake,
@@ -493,11 +591,29 @@ public interface EntitySupplier {
                 commandId
             )
 
+    /**
+     * Gets a [GlobalApplicationCommand] for a given [commandId].
+     *
+     * @param applicationId The application to get the command for
+     * @param commandId The ID of the command
+     * @return a [GlobalApplicationCommand] for the given [commandId].
+     * @throws RequestException if something went wrong during the request
+     * @throws EntityNotFoundException if the flow was null
+     */
     public suspend fun getGlobalApplicationCommandOrNull(
         applicationId: Snowflake,
         commandId: Snowflake
     ): GlobalApplicationCommand?
 
+    /**
+     * Gets a [GlobalApplicationCommand] for a given [commandId].
+     * returns `null` if the command was not present
+     *
+     * @param applicationId The application to get the command for
+     * @param commandId The ID of the command
+     * @return a [GlobalApplicationCommand] for the given [commandId].
+     * @throws RequestException if something went wrong during the request
+     */
     public suspend fun getGlobalApplicationCommand(
         applicationId: Snowflake,
         commandId: Snowflake
@@ -505,16 +621,44 @@ public interface EntitySupplier {
         getGlobalApplicationCommandOrNull(applicationId, commandId)
             ?: EntityNotFoundException.applicationCommandNotFound<GlobalApplicationCommand>(commandId)
 
+    /**
+     * Gets the [GlobalApplicationCommand]s for a given [applicationId].
+     *
+     * @param applicationId The application to get the commands for
+     * @param withLocalizations Whether to get the commands with localizations or not. Defaults to `null`
+     * @return a [Flow] of [GlobalApplicationCommand]s for the given [applicationId].
+     * @throws RequestException if something went wrong during the request
+     * @throws EntityNotFoundException if the flow was null
+     */
     public fun getGlobalApplicationCommands(applicationId: Snowflake, withLocalizations: Boolean? = null): Flow<GlobalApplicationCommand>
 
 
+    /**
+     * Gets the [ApplicationCommandPermissions] for a given [commandId].
+     * returns `null` if the permissions are not found
+     *
+     * @param applicationId The ID of the application to get the command for
+     * @param guildId The ID of the guild
+     * @param commandId The ID of the command to get
+     * @return The [ApplicationCommandPermissions] or `null` if they were not found
+     * @throws RequestException if something went wrong during the request
+     */
     public suspend fun getApplicationCommandPermissionsOrNull(
         applicationId: Snowflake,
         guildId: Snowflake,
         commandId: Snowflake,
     ): ApplicationCommandPermissions?
 
-
+    /**
+     * Gets the [ApplicationCommandPermissions] for a given [commandId].
+     *
+     * @param applicationId The ID of the application to get the command for
+     * @param guildId The ID of the guild
+     * @param commandId The ID of the command to get
+     * @return The [ApplicationCommandPermissions] or throws an [EntityNotFoundException] if they were not found
+     * @throws RequestException if something went wrong during the request
+     * @throws EntityNotFoundException if the permissions was null
+     */
     public suspend fun getApplicationCommandPermissions(
         applicationId: Snowflake,
         guildId: Snowflake,
@@ -523,6 +667,15 @@ public interface EntitySupplier {
         ?: EntityNotFoundException.applicationCommandPermissionsNotFound(commandId)
 
 
+    /**
+     * Gets the [ApplicationCommandPermissions] for a given [guildId].
+     *
+     * @param applicationId The ID of the application to get the command for
+     * @param guildId The ID of the guild
+     * @return a [Flow] of  [ApplicationCommandPermissions] for the given [guildId]
+     * @throws RequestException if something went wrong during the request
+     * @throws EntityNotFoundException if the flow was null
+     */
     public fun getGuildApplicationCommandPermissions(
         applicationId: Snowflake,
         guildId: Snowflake,
@@ -554,17 +707,61 @@ public interface EntitySupplier {
         getFollowupMessageOrNull(applicationId, interactionToken, messageId)
             ?: EntityNotFoundException.followupMessageNotFound(interactionToken, messageId)
 
+    /**
+     * Gets the [GuildScheduledEvent] for a given [guildId].
+     *
+     * @param guildId The ID of the guild
+     * @return a [Flow] of  [GuildScheduledEvent] for the given [guildId]
+     * @throws RequestException if something went wrong during the request
+     * @throws EntityNotFoundException if the flow was null
+     */
     public fun getGuildScheduledEvents(guildId: Snowflake): Flow<GuildScheduledEvent>
 
+    /**
+     * Gets the [GuildScheduledEvent] for a given [eventId].
+     * returns `null` if the event was not found
+     *
+     * @param guildId The ID of the guild
+     * @param eventId The ID of the event to get
+     * @return The [GuildScheduledEvent] or `null` if it was not found
+     * @throws RequestException if something went wrong during the request
+     */
     public suspend fun getGuildScheduledEventOrNull(guildId: Snowflake, eventId: Snowflake): GuildScheduledEvent?
 
+    /**
+     * Gets the [GuildScheduledEvent] for a given [eventId].
+     *
+     * @param guildId The ID of the guild
+     * @param eventId The ID of the event to get
+     * @return The [GuildScheduledEvent] or throws an [EntityNotFoundException] if it was not found
+     * @throws RequestException if something went wrong during the request
+     * @throws EntityNotFoundException if the event was null
+     */
     public suspend fun getGuildScheduledEvent(guildId: Snowflake, eventId: Snowflake): GuildScheduledEvent =
         getGuildScheduledEventOrNull(guildId, eventId) ?: EntityNotFoundException.guildScheduledEventNotFound(eventId)
 
-
+    /**
+     * Gets the [GuildScheduledEvent] [User]s for a given [eventId].
+     *
+     * @param guildId The ID of the guild
+     * @param eventId The ID of the event to get
+     * @param limit The limit on the number of [User]s that can be collected for the flow
+     * @return A [Flow] of [User]s for the [eventId]
+     * @throws RequestException if something went wrong during the request
+     */
     public fun getGuildScheduledEventUsers(guildId: Snowflake, eventId: Snowflake, limit: Int? = null): Flow<User> =
         getGuildScheduledEventUsersAfter(guildId, eventId, after = Snowflake.min, limit)
 
+    /**
+     * Gets the [GuildScheduledEvent] [User]s for a given [eventId] before a given time.
+     *
+     * @param guildId The ID of the guild
+     * @param eventId The ID of the event to get
+     * @param before The ID to look before
+     * @param limit The limit on the number of [User]s that can be collected for the flow
+     * @return A [Flow] of [User]s for the [eventId]
+     * @throws RequestException if something went wrong during the request
+     */
     public fun getGuildScheduledEventUsersBefore(
         guildId: Snowflake,
         eventId: Snowflake,
@@ -572,6 +769,16 @@ public interface EntitySupplier {
         limit: Int? = null,
     ): Flow<User>
 
+    /**
+     * Gets the [GuildScheduledEvent] [User]s for a given [eventId] after a given time.
+     *
+     * @param guildId The ID of the guild
+     * @param eventId The ID of the event to get
+     * @param after The ID to look after
+     * @param limit The limit on the number of [User]s that can be collected for the flow
+     * @return A [Flow] of [User]s for the [eventId]
+     * @throws RequestException if something went wrong during the request
+     */
     public fun getGuildScheduledEventUsersAfter(
         guildId: Snowflake,
         eventId: Snowflake,
@@ -579,10 +786,28 @@ public interface EntitySupplier {
         limit: Int? = null,
     ): Flow<User>
 
-
+    /**
+     * Gets the [GuildScheduledEvent] [Member]s for a given [eventId].
+     *
+     * @param guildId The ID of the guild
+     * @param eventId The ID of the event to get
+     * @param limit The limit on the number of [Member]s that can be collected for the flow
+     * @return A [Flow] of [Message]s for the [eventId]
+     * @throws RequestException if something went wrong during the request
+     */
     public fun getGuildScheduledEventMembers(guildId: Snowflake, eventId: Snowflake, limit: Int? = null): Flow<Member> =
         getGuildScheduledEventMembersAfter(guildId, eventId, after = Snowflake.min, limit)
 
+    /**
+     * Gets the [GuildScheduledEvent] [Member]s for a given [eventId] before a given time.
+     *
+     * @param guildId The ID of the guild
+     * @param eventId The ID of the event to get
+     * @param before The ID to look before
+     * @param limit The limit on the number of [Member]s that can be collected for the flow
+     * @return A [Flow] of [Message]s for the [eventId]
+     * @throws RequestException if something went wrong during the request
+     */
     public fun getGuildScheduledEventMembersBefore(
         guildId: Snowflake,
         eventId: Snowflake,
@@ -590,6 +815,16 @@ public interface EntitySupplier {
         limit: Int? = null,
     ): Flow<Member>
 
+    /**
+     * Gets the [GuildScheduledEvent] [Member]s for a given [eventId] after a given time.
+     *
+     * @param guildId The ID of the guild
+     * @param eventId The ID of the event to get
+     * @param after The ID to look after
+     * @param limit The limit on the number of [Member]s that can be collected for the flow
+     * @return A [Flow] of [Message]s for the [eventId]
+     * @throws RequestException if something went wrong during the request
+     */
     public fun getGuildScheduledEventMembersAfter(
         guildId: Snowflake,
         eventId: Snowflake,
@@ -598,18 +833,63 @@ public interface EntitySupplier {
     ): Flow<Member>
 
 
+    /**
+     * Gets a [Sticker] from a given [id].
+     * returns `null` if the sticker was not found
+     *
+     * @param id The ID of the sticker to get
+     * @return The [Sticker] or null
+     * @throws RequestException if something went wrong during the request
+     */
     public suspend fun getStickerOrNull(id: Snowflake): Sticker?
 
+    /**
+     * Gets a [Sticker] from a given [id].
+     *
+     * @param id The ID of the sticker to get
+     * @return The [Sticker] or throws an [EntityNotFoundException] if the sticker was not found
+     * @throws RequestException if something went wrong during the request
+     * @throws EntityNotFoundException if the sticker was null
+     */
     public suspend fun getSticker(id: Snowflake): Sticker =
         getStickerOrNull(id) ?: EntityNotFoundException.stickerNotFound(id)
 
+    /**
+     * Gets a [GuildSticker] from a given [id].
+     * returns `null` if the sticker was not found
+     *
+     * @param id The ID of the sticker to get
+     * @return The [GuildSticker] or null
+     * @throws RequestException if something went wrong during the request
+     */
     public suspend fun getGuildStickerOrNull(guildId: Snowflake, id: Snowflake): GuildSticker?
 
+    /**
+     * Gets a [GuildSticker] from a given [id].
+     *
+     * @param id The ID of the sticker to get
+     * @return The [GuildSticker] or throws an [EntityNotFoundException] if the sticker was not found
+     * @throws RequestException if something went wrong during the request
+     * @throws EntityNotFoundException if the sticker was null
+     */
     public suspend fun getGuildSticker(guildId: Snowflake, id: Snowflake): GuildSticker =
         getGuildStickerOrNull(guildId, id) ?: EntityNotFoundException.stickerNotFound(id)
 
+    /**
+     * Gets the [StickerPack]s that require nitro.
+     *
+     * @return A [Flow] of [StickerPack]s that require nitro
+     * @throws RequestException if something went wrong during the request
+     */
     public fun getNitroStickerPacks(): Flow<StickerPack>
 
+    /**
+     * Gets the [GuildSticker]s from a given [guildId].
+     *
+     * @param guildId The ID of the guild to get stickers for
+     * @return A [Flow] of [GuildSticker]s
+     * @throws RequestException if something went wrong during the request
+     */
     public fun getGuildStickers(guildId: Snowflake): Flow<GuildSticker>
 
     /**
diff --git a/core/src/commonMain/kotlin/supplier/RestEntitySupplier.kt b/core/src/commonMain/kotlin/supplier/RestEntitySupplier.kt
index 479e6aaf93ad..97d948458ddb 100644
--- a/core/src/commonMain/kotlin/supplier/RestEntitySupplier.kt
+++ b/core/src/commonMain/kotlin/supplier/RestEntitySupplier.kt
@@ -202,6 +202,15 @@ public class RestEntitySupplier(public val kord: Kord) : EntitySupplier {
         }
     }
 
+    /**
+     * Gets the [User]s that reactive to a given [messageId]
+     *
+     * @param channelId The ID of the channel the message was in
+     * @param messageId The ID of the message reacted too
+     * @param emoji The [ReactionEmoji] that was reacted with
+     * @return a [Flow] of [User]s that reacted to a message
+     * @throws RestRequestException when the request failed.
+     */
     public fun getReactors(channelId: Snowflake, messageId: Snowflake, emoji: ReactionEmoji): Flow<User> =
         // max batchSize/limit: see https://discord.com/developers/docs/resources/channel#get-reactions
         paginateForwards(batchSize = 100, idSelector = { it.id }) { after ->
@@ -269,6 +278,16 @@ public class RestEntitySupplier(public val kord: Kord) : EntitySupplier {
         Message(data, kord)
     }
 
+    /**
+     * Gets an [Invite] from a given [code].
+     * returns `null` if the invite was not found
+     *
+     * @param code The invite code
+     * @param withCounts Whether the invite should contain approximate member counts
+     * @param withExpiration Whether the invite should contain the expiration date
+     * @param scheduledEventId The guild scheduled event to include with the invite
+     * @throws RestRequestException when the request failed.
+     */
     public suspend fun getInviteOrNull(
         code: String,
         withCounts: Boolean = true,
@@ -279,6 +298,16 @@ public class RestEntitySupplier(public val kord: Kord) : EntitySupplier {
         Invite(InviteData.from(response), kord)
     }
 
+    /**
+     * Gets an [Invite] from a given [code]
+     *
+     * @param code The invite code
+     * @param withCounts Whether the invite should contain approximate member counts
+     * @param withExpiration Whether the invite should contain the expiration date
+     * @param scheduledEventId The guild scheduled event to include with the invite
+     * @throws RestRequestException when the request failed.
+     * @throws EntityNotFoundException if the invite was null
+     */
     public suspend fun getInvite(
         code: String,
         withCounts: Boolean = true,
@@ -315,7 +344,14 @@ public class RestEntitySupplier(public val kord: Kord) : EntitySupplier {
         }
     }
 
-
+    /**
+     * Gets the [DiscordAuditLogEntry]s for a given [guildId]
+     *
+     * @param guildId The ID of the guild to get the entries for
+     * @param builder The [AuditLogGetRequestBuilder] to modify the request
+     * @return A [Flow] of [DiscordAuditLogEntry]s for the [guildId]
+     * @throws RestRequestException when the request failed.
+     */
     public inline fun getAuditLogEntries(
         guildId: Snowflake,
         builder: AuditLogGetRequestBuilder.() -> Unit
@@ -324,11 +360,27 @@ public class RestEntitySupplier(public val kord: Kord) : EntitySupplier {
         return getAuditLogEntries(guildId, AuditLogGetRequestBuilder().apply(builder).toRequest())
     }
 
+    /**
+     * Gets the [WelcomeScreen] for a given [guildId].
+     * returns `null` if the screen was not found
+     *
+     * @param guildId The ID of the guild to get the screen for
+     * @return The [WelcomeScreen] or `null`
+     * @throws RestRequestException when the request failed.
+     */
     public suspend fun getGuildWelcomeScreenOrNull(guildId: Snowflake): WelcomeScreen? = catchNotFound {
         val response = guild.getGuildWelcomeScreen(guildId)
         WelcomeScreen(WelcomeScreenData.from(response), kord)
     }
 
+    /**
+     * Gets the [WelcomeScreen] for a given [guild]
+     *
+     * @param guildId The ID of the guild to get the screen for
+     * @return The [WelcomeScreen]
+     * @throws RestRequestException when the request failed.
+     * @throws EntityNotFoundException if the screen was null
+     */
     public suspend fun getGuildWelcomeScreen(guildId: Snowflake): WelcomeScreen =
         getGuildWelcomeScreenOrNull(guildId) ?: EntityNotFoundException.welcomeScreenNotFound(guildId)
 
@@ -353,6 +405,14 @@ public class RestEntitySupplier(public val kord: Kord) : EntitySupplier {
         getGuildOnboardingOrNull(guildId) ?: EntityNotFoundException.onboardingNotFound(guildId)
 
 
+    /**
+     * Gets the [DiscordAuditLogEntry]s for a given [guildId]
+     *
+     * @param guildId The ID of the guild to get the entries for
+     * @param request The [AuditLogGetRequest]
+     * @return A [Flow] of [DiscordAuditLogEntry]s for the [guildId]
+     * @throws RestRequestException when the request failed.
+     */
     // maxBatchSize: see https://discord.com/developers/docs/resources/audit-log#get-guild-audit-log
     public fun getAuditLogEntries(
         guildId: Snowflake,