Update docs with supported clj/cljs versions and nREPL setup

Also added a few pointers for committers

Author: cldwalker

README.md

@@ -2,6 +2,14 @@
 
 The official Clojure language plugin for Light Table.
 
+## Supported Clojure versions
+
+This plugin requires projects Clojure 1.5.1 and higher. Starting with 0.2.0 this plugin will only be maintained for projects with Clojure 1.7.0 and higher.
+
+## Supported ClojureScript versions
+
+This plugin works for projects on recent versions of ClojureScript e.g. 1.7.X. For projects with ClojureScript versions 0.0-2341 and higher, Clojure 1.7.0 is required.
+
 ## First ClojureScript Repl
 
 Welcome first time ClojureScript users! Please see [David Nolen's tutorial](https://github.com/swannodette/lt-cljs-tutorial) to get familiar with ClojureScript and comfortable with LightTable's repl. Note while doing that tutorial you were in a namespace. A namespace is necessary for a LightTable repl. Once you have finished the tutorial, create your own ClojureScript project with `lein new mies my-project` and eval there. If you want to add dependencies to your project, read the [below section](#clojurescript-eval) as that requires a different type of LightTable connection.
@@ -33,14 +41,37 @@ For LightTable plugins:
 Your project is connected to `LightTable UI`. When you save any plugin cljs file, compiled js is generated and saved. Any change
 can be eval-ed.
 
+## Connect to remote nREPL
+
+When you eval a Clojure project, Light Table automatically starts an nREPL server and connects to it. If you'd prefer to start an nREPL server,
+open the `Connections` panel, press `Add Connection` button and select the `Clojure (remote nREPL)` client. Make sure your project.clj
+has the following `:dependencies` and `:repl-options`:
+
+```clojure
+(defproject lttest "0.1.0-SNAPSHOT"
+  :description "FIXME: write description"
+  :dependencies [[org.clojure/clojure "1.6.0"]
+                 [lein-light-nrepl "X.X.X"]]
+  :repl-options {:nrepl-middleware [lighttable.nrepl.handler/lighttable-ops]})
+```
+
+For projects using Clojure >= 1.5.1 and < 1.7.0, `X.X.X` refers to `0.1.3`, an older unmaintained version.
+For projects using Clojure >= 1.7.0, `X.X.X` refers to the latest version of `lein-light-nrepl`:
+
+[![Clojars Project](http://clojars.org/lein-light-nrepl/latest-version.svg)](http://clojars.org/lein-light-nrepl)
+
 ## License
 
 Distributed under the MIT License, see license.md for the full text.
 
-## For Commiters
+## For Committers
 
+* Project layout
+  * runner/: Contains uberjar to inject our nREPL middleware into a project and then start a repl
+  * lein-light-nrepl/: Contains nREPL middleware that needs to be deployed to Clojars when changed
+  * src/ and everything else: Normal LightTable plugin
 * When releasing a new plugin version and lein-light-nrepl has changed:
   * Bump lein-light-nrepl and lein-light in runner/.
-  * Update the uberjar with `lein uberjar` in `runner/target/lein-light-standalone.jar`.
+  * Update the uberjar with `lein uberjar` in `runner` to produce `runner/target/lein-light-standalone.jar`.
   * Release the new version of lein-light-nrepl to [clojars](https://clojars.org/lein-light-nrepl)
 * No process for upgrading `clojure-mode.js` until [this issue](https://github.com/LightTable/Clojure/issues/26) is addressed.