Add kdoc and remove redundant annotation dependency

Author: bnvinay92

workflow-core/build.gradle.kts

@@ -30,10 +30,5 @@ kotlin {
         implementation(libs.kotlin.test.jdk)
       }
     }
-    val jvmMain by getting {
-      dependencies {
-        compileOnly(libs.jetbrains.annotations)
-      }
-    }
   }
 }

workflow-core/src/commonMain/kotlin/com/squareup/workflow1/WorkflowIdentifier.kt

@@ -38,8 +38,8 @@ import kotlin.reflect.KType
  * snapshotted.
  *
  * @constructor
- * @param type The [KClass] of the [Workflow] this identifier identifies, or the [KType] of an
- * [unsnapshottableIdentifier].
+ * @param type Wrapper around the [KClass] of the [Workflow] this identifier identifies, or the
+ * [KType] of an [unsnapshottableIdentifier].
  * @param proxiedIdentifier An optional identifier from [ImpostorWorkflow.realIdentifier] that will
  * be used to further narrow the scope of this identifier.
  * @param description Implementation of [ImpostorWorkflow.describeRealIdentifier].

workflow-core/src/commonMain/kotlin/com/squareup/workflow1/WorkflowIdentifierType.kt

@@ -3,10 +3,22 @@ package com.squareup.workflow1
 import kotlin.reflect.KClass
 import kotlin.reflect.KType
 
+/**
+ * Represents a subset of [KAnnotatedElement], namely [KClass] or [KType]. Used by the runtime to
+ * determine whether a [WorkflowIdentifier], and thus the [Workflow] it identifies, is serializable
+ * or not via the [Snapshot] mechanism.
+ */
 public sealed class WorkflowIdentifierType {
 
   public abstract val typeName: String
 
+  /**
+   * A [WorkflowIdentifier] is snapshottable if its type is this [Snapshottable] class.
+   *
+   * @constructor
+   * @param typeName The qualified name of its corresponding [Workflow].
+   * @param kClass The [KClass] of the [Workflow] this helps identify.
+   */
   public data class Snapshottable(
     override val typeName: String,
     val kClass: KClass<*>? = null,
@@ -16,6 +28,12 @@ public sealed class WorkflowIdentifierType {
     )
   }
 
+  /**
+   * A [WorkflowIdentifier] is unsnapshottable if its type is this [Unsnapshottable] class.
+   *
+   * @constructor
+   * @param kType The [KType] of the [Workflow] this helps identify.
+   */
   public data class Unsnapshottable(val kType: KType) : WorkflowIdentifierType() {
     init {
       require(kType.classifier is KClass<*>) {