[Gradle] Add KDoc for KotlinTestRun

^KT-58858 In Progress

Author: Tapchicoma

libraries/tools/kotlin-gradle-plugin-api/src/common/kotlin/org/jetbrains/kotlin/gradle/plugin/KotlinTestRun.kt

@@ -10,39 +10,58 @@ import org.gradle.api.file.FileCollection
 import org.gradle.api.tasks.testing.TestFilter
 
 /**
- * @suppress TODO: KT-58858 add documentation
+ * A [KotlinExecution] that runs configured tests.
  */
 interface KotlinTestRun<out SourceType : KotlinExecution.ExecutionSource> : KotlinExecution<SourceType> {
+
+    /**
+     * Configures filtering for executable tests using the provided [configureFilter] configuration.
+     */
     fun filter(configureFilter: TestFilter.() -> Unit)
 
+    /**
+     * Configures filtering for executable tests using the provided [configureFilter] configuration.
+     */
     fun filter(configureFilter: Closure<*>)
 }
 
 /**
- * @suppress TODO: KT-58858 add documentation
+ * A [KotlinTargetExecution] that executes configured tests in the context of a specific [KotlinTarget].
  */
 interface KotlinTargetTestRun<ExecutionSource : KotlinExecution.ExecutionSource> :
     KotlinTestRun<ExecutionSource>,
     KotlinTargetExecution<ExecutionSource>
 
 /**
- * @suppress TODO: KT-58858 add documentation
+ * A [KotlinExecution.ExecutionSource] that provides the [classpath] and [testClassesDirs] where JVM test classes can be found.
  */
 interface JvmClasspathTestRunSource : KotlinExecution.ExecutionSource {
+
+    /**
+     * The part of the classpath where JVM test classes are located for execution.
+     */
     val testClassesDirs: FileCollection
+
+    /**
+     * The tests classpath.
+     *
+     * This includes dependencies and/or test framework classes such as JUnit, TestNG, or any other test framework classes.
+     */
     val classpath: FileCollection
 }
 
 /**
- * @suppress TODO: KT-58858 add documentation
+ * Configures the [JvmClasspathTestRunSource].
  */
 interface ClasspathTestRunSourceSupport {
+
     /**
-     * Select the exact [classpath] to run the tests from.
+     * Configures values for the [JvmClasspathTestRunSource].
      *
-     * Only the classes from [testClasses] will be treated as tests.
+     * Calling this method overwrites any already configured values in the [JvmClasspathTestRunSource].
      *
-     * This overrides other [KotlinExecution.executionSource] selection options.
+     * @param [classpath] Tests classpath
+     * @param [testClassesDirs] Only the classes from this [FileCollection] are treated as tests.
      */
     fun setExecutionSourceFrom(classpath: FileCollection, testClassesDirs: FileCollection)
 }