better comment

Author: mkleene

sdk/src/main/kotlin/io/opentdf/platform/sdk/RequestHelper.kt

@@ -7,9 +7,11 @@ import com.connectrpc.getOrThrow
 class RequestHelper {
     companion object {
         /**
-         * Kotlin doesn't have checked exceptions so that if we want to catch
-         * an exception thrown by Kotlin we need to declare that the method throws it.
-         * ResponseMessageKt.getOrThrow() doesn't do so; so we need to wrap it
+         * Kotlin doesn't have checked exceptions (importantly it doesn't declare them).
+         *  This means that if a Kotlin function throws a checked exception, you can't
+         *  catch it in Java unless it uses the {@class kotlin.jvm.Throws} annotation.
+         *  We wrap the getOrThrow() method in a static method with the annotation we
+         *  need to catch a {@class ConnectException} in Java.
          */
         @JvmStatic @Throws(ConnectException::class)
         fun <T> getOrThrow(responseMessage: ResponseMessage<T>): T {