diff --git a/common/build/generated/ksp/metadata/commonMain/kotlin/dev/kord/common/entity/ActivityFlag.kt b/common/build/generated/ksp/metadata/commonMain/kotlin/dev/kord/common/entity/ActivityFlag.kt
index 3351509a9eb..9d564572c0a 100644
--- a/common/build/generated/ksp/metadata/commonMain/kotlin/dev/kord/common/entity/ActivityFlag.kt
+++ b/common/build/generated/ksp/metadata/commonMain/kotlin/dev/kord/common/entity/ActivityFlag.kt
@@ -79,8 +79,14 @@ import kotlinx.serialization.encoding.Encoder
  */
 @Serializable(with = ActivityFlags.Serializer::class)
 public class ActivityFlags internal constructor(
+    /**
+     * The raw value used by Discord.
+     */
     public val `value`: Int,
 ) {
+    /**
+     * A [Set] of all [ActivityFlag]s contained in this instance of [ActivityFlags].
+     */
     public val values: Set<ActivityFlag>
         get() = buildSet {
             var remaining = value
@@ -92,6 +98,9 @@ public class ActivityFlags internal constructor(
             }
         }
 
+    /**
+     * @suppress
+     */
     @Deprecated(
         message = "Renamed to 'values'.",
         replaceWith = ReplaceWith(expression = "this.values", imports = arrayOf()),
diff --git a/common/build/generated/ksp/metadata/commonMain/kotlin/dev/kord/common/entity/ApplicationFlag.kt b/common/build/generated/ksp/metadata/commonMain/kotlin/dev/kord/common/entity/ApplicationFlag.kt
index 8ce95389e5d..83217997f4b 100644
--- a/common/build/generated/ksp/metadata/commonMain/kotlin/dev/kord/common/entity/ApplicationFlag.kt
+++ b/common/build/generated/ksp/metadata/commonMain/kotlin/dev/kord/common/entity/ApplicationFlag.kt
@@ -83,8 +83,14 @@ import kotlinx.serialization.encoding.Encoder
  */
 @Serializable(with = ApplicationFlags.Serializer::class)
 public class ApplicationFlags internal constructor(
+    /**
+     * The raw code used by Discord.
+     */
     public val code: Int,
 ) {
+    /**
+     * A [Set] of all [ApplicationFlag]s contained in this instance of [ApplicationFlags].
+     */
     public val values: Set<ApplicationFlag>
         get() = buildSet {
             var remaining = code
@@ -96,6 +102,9 @@ public class ApplicationFlags internal constructor(
             }
         }
 
+    /**
+     * @suppress
+     */
     @Deprecated(
         message = "Renamed to 'values'.",
         replaceWith = ReplaceWith(expression = "this.values", imports = arrayOf()),
diff --git a/common/build/generated/ksp/metadata/commonMain/kotlin/dev/kord/common/entity/ChannelFlag.kt b/common/build/generated/ksp/metadata/commonMain/kotlin/dev/kord/common/entity/ChannelFlag.kt
index ed0a9957635..6bde5ae1c9a 100644
--- a/common/build/generated/ksp/metadata/commonMain/kotlin/dev/kord/common/entity/ChannelFlag.kt
+++ b/common/build/generated/ksp/metadata/commonMain/kotlin/dev/kord/common/entity/ChannelFlag.kt
@@ -79,8 +79,14 @@ import kotlinx.serialization.encoding.Encoder
  */
 @Serializable(with = ChannelFlags.Serializer::class)
 public class ChannelFlags internal constructor(
+    /**
+     * The raw code used by Discord.
+     */
     public val code: Int,
 ) {
+    /**
+     * A [Set] of all [ChannelFlag]s contained in this instance of [ChannelFlags].
+     */
     public val values: Set<ChannelFlag>
         get() = buildSet {
             var remaining = code
@@ -92,6 +98,9 @@ public class ChannelFlags internal constructor(
             }
         }
 
+    /**
+     * @suppress
+     */
     @Deprecated(
         message = "Renamed to 'values'.",
         replaceWith = ReplaceWith(expression = "this.values", imports = arrayOf()),
diff --git a/common/build/generated/ksp/metadata/commonMain/kotlin/dev/kord/common/entity/GuildMemberFlag.kt b/common/build/generated/ksp/metadata/commonMain/kotlin/dev/kord/common/entity/GuildMemberFlag.kt
index 5484a075361..d3442032366 100644
--- a/common/build/generated/ksp/metadata/commonMain/kotlin/dev/kord/common/entity/GuildMemberFlag.kt
+++ b/common/build/generated/ksp/metadata/commonMain/kotlin/dev/kord/common/entity/GuildMemberFlag.kt
@@ -82,8 +82,14 @@ import kotlinx.serialization.encoding.Encoder
  */
 @Serializable(with = GuildMemberFlags.Serializer::class)
 public class GuildMemberFlags internal constructor(
+    /**
+     * The raw code used by Discord.
+     */
     public val code: Int,
 ) {
+    /**
+     * A [Set] of all [GuildMemberFlag]s contained in this instance of [GuildMemberFlags].
+     */
     public val values: Set<GuildMemberFlag>
         get() = buildSet {
             var remaining = code
diff --git a/common/build/generated/ksp/metadata/commonMain/kotlin/dev/kord/common/entity/MessageFlag.kt b/common/build/generated/ksp/metadata/commonMain/kotlin/dev/kord/common/entity/MessageFlag.kt
index 689a3f37820..50d29f55356 100644
--- a/common/build/generated/ksp/metadata/commonMain/kotlin/dev/kord/common/entity/MessageFlag.kt
+++ b/common/build/generated/ksp/metadata/commonMain/kotlin/dev/kord/common/entity/MessageFlag.kt
@@ -79,8 +79,14 @@ import kotlinx.serialization.encoding.Encoder
  */
 @Serializable(with = MessageFlags.Serializer::class)
 public class MessageFlags internal constructor(
+    /**
+     * The raw code used by Discord.
+     */
     public val code: Int,
 ) {
+    /**
+     * A [Set] of all [MessageFlag]s contained in this instance of [MessageFlags].
+     */
     public val values: Set<MessageFlag>
         get() = buildSet {
             var remaining = code
@@ -92,6 +98,9 @@ public class MessageFlags internal constructor(
             }
         }
 
+    /**
+     * @suppress
+     */
     @Deprecated(
         message = "Renamed to 'values'.",
         replaceWith = ReplaceWith(expression = "this.values", imports = arrayOf()),
diff --git a/common/build/generated/ksp/metadata/commonMain/kotlin/dev/kord/common/entity/Permission.kt b/common/build/generated/ksp/metadata/commonMain/kotlin/dev/kord/common/entity/Permission.kt
index c31543c4afa..f306ba0e1ee 100644
--- a/common/build/generated/ksp/metadata/commonMain/kotlin/dev/kord/common/entity/Permission.kt
+++ b/common/build/generated/ksp/metadata/commonMain/kotlin/dev/kord/common/entity/Permission.kt
@@ -75,8 +75,14 @@ import kotlinx.serialization.encoding.Encoder
  */
 @Serializable(with = Permissions.Serializer::class)
 public class Permissions internal constructor(
+    /**
+     * The raw code used by Discord.
+     */
     public val code: DiscordBitSet,
 ) {
+    /**
+     * A [Set] of all [Permission]s contained in this instance of [Permissions].
+     */
     public val values: Set<Permission>
         get() = buildSet {
             for (shift in 0..<code.size) {
diff --git a/common/build/generated/ksp/metadata/commonMain/kotlin/dev/kord/common/entity/SystemChannelFlag.kt b/common/build/generated/ksp/metadata/commonMain/kotlin/dev/kord/common/entity/SystemChannelFlag.kt
index 862ffe55891..9acd5f2f87b 100644
--- a/common/build/generated/ksp/metadata/commonMain/kotlin/dev/kord/common/entity/SystemChannelFlag.kt
+++ b/common/build/generated/ksp/metadata/commonMain/kotlin/dev/kord/common/entity/SystemChannelFlag.kt
@@ -83,8 +83,14 @@ import kotlinx.serialization.encoding.Encoder
  */
 @Serializable(with = SystemChannelFlags.Serializer::class)
 public class SystemChannelFlags internal constructor(
+    /**
+     * The raw code used by Discord.
+     */
     public val code: Int,
 ) {
+    /**
+     * A [Set] of all [SystemChannelFlag]s contained in this instance of [SystemChannelFlags].
+     */
     public val values: Set<SystemChannelFlag>
         get() = buildSet {
             var remaining = code
diff --git a/common/build/generated/ksp/metadata/commonMain/kotlin/dev/kord/common/entity/UserFlag.kt b/common/build/generated/ksp/metadata/commonMain/kotlin/dev/kord/common/entity/UserFlag.kt
index f91d71ef642..fcfae65d606 100644
--- a/common/build/generated/ksp/metadata/commonMain/kotlin/dev/kord/common/entity/UserFlag.kt
+++ b/common/build/generated/ksp/metadata/commonMain/kotlin/dev/kord/common/entity/UserFlag.kt
@@ -79,8 +79,14 @@ import kotlinx.serialization.encoding.Encoder
  */
 @Serializable(with = UserFlags.Serializer::class)
 public class UserFlags internal constructor(
+    /**
+     * The raw code used by Discord.
+     */
     public val code: Int,
 ) {
+    /**
+     * A [Set] of all [UserFlag]s contained in this instance of [UserFlags].
+     */
     public val values: Set<UserFlag>
         get() = buildSet {
             var remaining = code
@@ -92,6 +98,9 @@ public class UserFlags internal constructor(
             }
         }
 
+    /**
+     * @suppress
+     */
     @Deprecated(
         message = "Renamed to 'values'.",
         replaceWith = ReplaceWith(expression = "this.values", imports = arrayOf()),
diff --git a/gateway/build/generated/ksp/metadata/commonMain/kotlin/dev/kord/gateway/Intent.kt b/gateway/build/generated/ksp/metadata/commonMain/kotlin/dev/kord/gateway/Intent.kt
index e530cf28916..b2849c2cdfb 100644
--- a/gateway/build/generated/ksp/metadata/commonMain/kotlin/dev/kord/gateway/Intent.kt
+++ b/gateway/build/generated/ksp/metadata/commonMain/kotlin/dev/kord/gateway/Intent.kt
@@ -75,8 +75,14 @@ import kotlinx.serialization.encoding.Encoder
  */
 @Serializable(with = Intents.Serializer::class)
 public class Intents internal constructor(
+    /**
+     * The raw code used by Discord.
+     */
     public val code: DiscordBitSet,
 ) {
+    /**
+     * A [Set] of all [Intent]s contained in this instance of [Intents].
+     */
     public val values: Set<Intent>
         get() = buildSet {
             for (shift in 0..<code.size) {
diff --git a/ksp-processors/src/main/kotlin/generation/bitflags/BitFlagsGeneration.kt b/ksp-processors/src/main/kotlin/generation/bitflags/BitFlagsGeneration.kt
index e42a9f1d5cd..5c071c08ed4 100644
--- a/ksp-processors/src/main/kotlin/generation/bitflags/BitFlagsGeneration.kt
+++ b/ksp-processors/src/main/kotlin/generation/bitflags/BitFlagsGeneration.kt
@@ -32,9 +32,11 @@ internal fun BitFlags.generateFileSpec(originatingFile: KSFile) = fileSpecForGen
             addParameter(valueName, valueCN)
         }
         addProperty(valueName, valueCN, PUBLIC) {
+            addKdoc("The raw $valueName used by Discord.")
             initializer(valueName)
         }
         addProperty("values", type = SET.parameterizedBy(entityCN), PUBLIC) {
+            addKdoc("A [Set] of all [%T]s contained in this instance of [%T].", entityCN, collectionCN)
             getter {
                 withControlFlow("return buildSet") {
                     when (valueType) {
@@ -57,6 +59,7 @@ internal fun BitFlags.generateFileSpec(originatingFile: KSFile) = fileSpecForGen
         if (hadFlagsProperty) {
             val type = (if (flagsPropertyWasSet) SET else LIST).parameterizedBy(entityCN)
             addProperty("flags", type, PUBLIC) {
+                addKdoc("@suppress")
                 @OptIn(DelicateKotlinPoetApi::class)
                 addAnnotation(
                     Deprecated(
diff --git a/voice/build/generated/ksp/main/kotlin/dev/kord/voice/SpeakingFlag.kt b/voice/build/generated/ksp/main/kotlin/dev/kord/voice/SpeakingFlag.kt
index 6726ba56a15..43a95d8e348 100644
--- a/voice/build/generated/ksp/main/kotlin/dev/kord/voice/SpeakingFlag.kt
+++ b/voice/build/generated/ksp/main/kotlin/dev/kord/voice/SpeakingFlag.kt
@@ -79,8 +79,14 @@ import kotlinx.serialization.encoding.Encoder
  */
 @Serializable(with = SpeakingFlags.Serializer::class)
 public class SpeakingFlags internal constructor(
+    /**
+     * The raw code used by Discord.
+     */
     public val code: Int,
 ) {
+    /**
+     * A [Set] of all [SpeakingFlag]s contained in this instance of [SpeakingFlags].
+     */
     public val values: Set<SpeakingFlag>
         get() = buildSet {
             var remaining = code
@@ -92,6 +98,9 @@ public class SpeakingFlags internal constructor(
             }
         }
 
+    /**
+     * @suppress
+     */
     @Deprecated(
         message = "Renamed to 'values'.",
         replaceWith = ReplaceWith(expression = "this.values", imports = arrayOf()),