From 1026b47e1c6fa8e7728c61ae9533cebb5300250a Mon Sep 17 00:00:00 2001
From: Yahor Berdnikau <yahor.berdnikau@jetbrains.com>
Date: Mon, 11 Nov 2024 22:37:27 +0100
Subject: [PATCH] [Gradle] Add KDoc for KotlinTargetWithTests

^KT-58858 In Progress
---
 .../kotlin/gradle/plugin/KotlinTarget.kt        | 17 ++++++++++++++---
 1 file changed, 14 insertions(+), 3 deletions(-)

diff --git a/libraries/tools/kotlin-gradle-plugin-api/src/common/kotlin/org/jetbrains/kotlin/gradle/plugin/KotlinTarget.kt b/libraries/tools/kotlin-gradle-plugin-api/src/common/kotlin/org/jetbrains/kotlin/gradle/plugin/KotlinTarget.kt
index 0319e674bc490..41aa039f98032 100644
--- a/libraries/tools/kotlin-gradle-plugin-api/src/common/kotlin/org/jetbrains/kotlin/gradle/plugin/KotlinTarget.kt
+++ b/libraries/tools/kotlin-gradle-plugin-api/src/common/kotlin/org/jetbrains/kotlin/gradle/plugin/KotlinTarget.kt
@@ -193,14 +193,25 @@ interface KotlinTarget : Named, HasAttributes, HasProject, HasMutableExtras {
 }
 
 /**
- * @suppress TODO: KT-58858 add documentation
+ * Represents a [KotlinTarget] that includes test runs.
  */
 interface KotlinTargetWithTests<E : KotlinExecution.ExecutionSource, T : KotlinTargetTestRun<E>> : KotlinTarget {
-    /** The container with the test run executions.
-     * A target may automatically create and configure a test run by the name [DEFAULT_TEST_RUN_NAME]. */
+
+    /**
+     * The container that holds test run executions.
+     *
+     * A test run by the name [DEFAULT_TEST_RUN_NAME] is automatically created and configured.
+     */
     val testRuns: NamedDomainObjectContainer<T>
 
+    /**
+     * [KotlinTargetWithTests] constants.
+     */
     companion object {
+
+        /**
+         * The name of the default [KotlinTargetTestRun] created by [KotlinTargetWithTests].
+         */
         const val DEFAULT_TEST_RUN_NAME = "test"
     }
 }