initial import from hsyed/rules_kotlin
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..d40ea1e
--- /dev/null
+++ b/README.md
@@ -0,0 +1,17 @@
+[Skydoc documentation](https://hsyed.github.io/rules_kotlin/kotlin/kotlin.html)
+
+# Overview
+
+These rules were initially forked from [pubref/rules_kotlin](http://github.com/pubref/rules_kotlin). Key changes:
+
+* Replace the macros with three basic rules. `kotlin_binary`, `kotlin_library` and `kotlin_test`.
+* Use a single dep attribute instead of `java_dep` and `dep`.
+* Add support for the following standard java rules attributes:
+ * `data`
+ * `resource_jars`
+ * `runtime_deps`
+ * `resources`
+ * `resources_strip_prefix`
+ * `exports`
+* Persistent worker support.
+* Mixed-Mode compilation (compile Java and Kotlin in one pass).
\ No newline at end of file
