README updates
diff --git a/ b/
index f343b24..f085ab0 100644
--- a/
+++ b/
@@ -1,5 +1,39 @@
 # [Apache Log4j 2 Kotlin API](
+Log4j Kotlin API is a Kotlin logging facade based on Log4j 2. Log4j Kotlin API provides Log4j 2 as its
+default logging implementation, but this is not strictly required (e.g., this API can also be used with Logback
+or other Log4j 2 API provider implementations). Idiomatic Kotlin features are provided as an alternative to using
+the Log4j 2 Java API.
+[![Build Status](](
+## Usage
+Gradle users can add the following dependencies to their `build.gradle` file:
+compile "org.apache.logging.log4j:log4j-api-kotlin:1.0"
+compile "org.apache.logging.log4j:log4j-api:2.8.2"
+compile "org.apache.logging.log4j:log4j-core:2.8.2"
+## Documentation
+[//]: # "The Log4j Kotlin API is documented [in the Log4j 2 manual]("
+[//]: # "and in the [KDocs]("
+## Requirements
+Log4j Kotlin API requires at least Java 7. This also requires Log4j 2 API, but it is specified as transitive
+dependencies automatically if you are using SBT, Maven, Gradle, or some other similar build system. This also
+requires Log4j 2 Core (or possibly an other implementation of Log4j 2 API) as a runtime dependency. Some
+Log4j 2 Core features require optional dependencies which are documented in the 
+[Log4j 2 manual](
 ## License
 Apache Log4j 2 is distributed under the [Apache License, version 2.0](
@@ -17,7 +51,15 @@
 Pull request on GitHub are welcome, but please open a ticket in the JIRA issue tracker first, and mention the 
 JIRA issue in the Pull Request.
-## Status
+## Building From Source
-This is work in progress to integrate Kotlin into log4j2 as a module. See issue
- for tracking information.
+Log4j Kotlin API requires Maven 3 and Java 8 to build. To install to your local
+Maven repository, execute the following:
+mvn install
+## Contributing
+We love contributions! Take a look at [our contributing page](