diff --git a/docs/kotlin/kotlin.html b/docs/kotlin/kotlin.html
index 21727dd..038e413 100644
--- a/docs/kotlin/kotlin.html
+++ b/docs/kotlin/kotlin.html
@@ -104,12 +104,7 @@
 <li><code>kotlin-test</code>,</li>
 <li><code>kotlin-reflect</code>.</li>
 </ul>
-<p>So if you needed to add reflect as a dep use the following label <code>@com_github_jetbrains_kotlin//:reflect</code>.</p>
-<h3>Caveats</h3>
-<ul>
-<li>The compiler is currently not configurable <a href="https://github.com/hsyed/rules_kotlin/issues/3">issue</a>.</li>
-<li>The compiler is hardwired to target jdk8 and language and api levels "1.2" <a href="https://github.com/hsyed/rules_kotlin/issues/3">issue</a>.</li>
-</ul>
+<p>So if you needed to add reflect as a dep use the following label <code>@com_github_jetbrains_kotlin//:kotlin-reflect</code>.</p>
 
           <hr>
 
@@ -240,6 +235,9 @@
           <pre>kt_jvm_import(<a href="#kt_jvm_import.name">name</a>, <a href="#kt_jvm_import.jars">jars</a>, <a href="#kt_jvm_import.srcjar">srcjar</a>)</pre>
 
           <p>(experimental) Import Kotlin jars.</p>
+<p><strong>Status:</strong> This rule is not a counterpart to <code>java_import</code>. The current purpose for this rule is to import a kotlin jar without creating ijars. It will
+eventually <a href="https://github.com/bazelbuild/rules_kotlin/issues/4">be replaced</a> with <code>java_import</code>. If there is a need for expanding this rule we can instead
+create a utility macro that delegates to this.</p>
 <h2>examples</h2>
 <pre><code class="lang-bzl"># Import a collection of class jars and source jars from filegroup labels.
 kt_jvm_import(
@@ -386,6 +384,10 @@
           <pre>kt_jvm_test(<a href="#kt_jvm_test.name">name</a>, <a href="#kt_jvm_test.deps">deps</a>, <a href="#kt_jvm_test.data">data</a>, <a href="#kt_jvm_test.resources">resources</a>, <a href="#kt_jvm_test.srcs">srcs</a>, <a href="#kt_jvm_test.jvm_flags">jvm_flags</a>, <a href="#kt_jvm_test.resource_jars">resource_jars</a>, <a href="#kt_jvm_test.resource_strip_prefix">resource_strip_prefix</a>, <a href="#kt_jvm_test.runtime_deps">runtime_deps</a>, <a href="#kt_jvm_test.test_class">test_class</a>)</pre>
 
           <p>Setup a simple kotlin_test.</p>
+<p><strong>Notes:</strong></p>
+<ul>
+<li>The kotlin test library is not added implicitly, it is available with the label <code>@com_github_jetbrains_kotlin//:kotlin-test</code>.</li>
+</ul>
 
 
           <h3 id="kt_jvm_test_args">Attributes</h3>
diff --git a/kotlin/kotlin.bzl b/kotlin/kotlin.bzl
index 8d7c736..f7880bd 100644
--- a/kotlin/kotlin.bzl
+++ b/kotlin/kotlin.bzl
@@ -43,12 +43,7 @@
 * `kotlin-test`,
 * `kotlin-reflect`.
 
-So if you needed to add reflect as a dep use the following label `@com_github_jetbrains_kotlin//:reflect`.
-
-### Caveats
-
-* The compiler is currently not configurable [issue](https://github.com/hsyed/rules_kotlin/issues/3).
-* The compiler is hardwired to target jdk8 and language and api levels "1.2" [issue](https://github.com/hsyed/rules_kotlin/issues/3).
+So if you needed to add reflect as a dep use the following label `@com_github_jetbrains_kotlin//:kotlin-reflect`.
 """
 # This file is the main import -- it shouldn't grow out of hand the reason it contains so much allready is due to the limitations of skydoc.
 
@@ -273,6 +268,10 @@
 )
 
 """Setup a simple kotlin_test.
+
+**Notes:**
+* The kotlin test library is not added implicitly, it is available with the label `@com_github_jetbrains_kotlin//:kotlin-test`.
+
 Args:
   test_class: The Java class to be loaded by the test runner.
 """
@@ -298,6 +297,10 @@
 #     ijars.
 """(experimental) Import Kotlin jars.
 
+**Status:** This rule is not a counterpart to `java_import`. The current purpose for this rule is to import a kotlin jar without creating ijars. It will
+eventually [be replaced](https://github.com/bazelbuild/rules_kotlin/issues/4) with `java_import`. If there is a need for expanding this rule we can instead
+create a utility macro that delegates to this.
+
 ## examples
 
 ```bzl