PY-28370 KDoc for `PyAddSdkView.finish()` improved

python/src/com/jetbrains/python/sdk/add/PyAddSdkPanel.kt

@@ -48,8 +48,7 @@ abstract class PyAddSdkPanel : JPanel(), PyAddSdkView {
 
   override fun next() = throw UnsupportedOperationException()
 
-  // TODO could we return `null`?
-  override fun finish(): Sdk = getOrCreateSdk() ?: throw IllegalStateException()
+  override fun finish(): Sdk = getOrCreateSdk() ?: throw IllegalStateException("Failed to create Python interpreter")
 
   override abstract val panelName: String
   override val icon: Icon = PythonIcons.Python.Python

python/src/com/jetbrains/python/sdk/add/PyAddSdkView.kt

@@ -42,7 +42,8 @@ interface PyAddSdkView {
   fun next()
 
   /**
-   * Creates SDK and returns it.
+   * Creates SDK and returns it. The returned SDK could be later obtained by
+   * [getOrCreateSdk] method.
    *
    * If some error occurs an [Exception] is thrown.
    *