Unify kotlin.test docs

libraries/kotlin.test/common/src/main/kotlin/kotlin/test/AssertionsH.kt

@@ -8,8 +8,9 @@ package kotlin.test
 import kotlin.reflect.KClass
 
 /**
- * Comments out a block of test code until it is implemented while keeping a link to the code
+ * Takes the given [block] of test code and _doesn't_ execute it.
- * to implement in your unit test output
+ *
+ * This keeps the code under test referenced, but doesn't actually test it until it is implemented.
  */
 expect fun todo(block: () -> Unit)
 

libraries/kotlin.test/js/src/main/kotlin/kotlin/test/JsImpl.kt

@@ -8,8 +8,9 @@ package kotlin.test
 import kotlin.reflect.KClass
 
 /**
- * Comments out a block of test code until it is implemented while keeping a link to the code
+ * Takes the given [block] of test code and _doesn't_ execute it.
- * to implement in your unit test output
+ *
+ * This keeps the code under test referenced, but doesn't actually test it until it is implemented.
  */
 actual fun todo(block: () -> Unit) {
     // println("TODO at " + (Exception() as java.lang.Throwable).getStackTrace()?.get(1) + " for " + block)

libraries/kotlin.test/jvm/src/main/kotlin/AssertionsImpl.kt

@@ -45,8 +45,9 @@ actual fun <T : Throwable> assertFailsWith(exceptionClass: KClass<T>, message: S
 
 
 /**
- * Comments out a [block] of test code until it is implemented while keeping a link to the code
+ * Takes the given [block] of test code and _doesn't_ execute it.
- * to implement in your unit test output
+ *
+ * This keeps the code under test referenced, but doesn't actually test it until it is implemented.
  */
 @InlineOnly
 actual inline fun todo(@Suppress("UNUSED_PARAMETER") block: () -> Unit) {