diff --git a/README.markdown b/README.markdown
new file mode 100644
--- /dev/null
+++ b/README.markdown
@@ -0,0 +1,31 @@
+This is a utility which monitors changes to the files in a directory.
+It was designed to make it easy to monitor parallel Cabal builds.
+
+The utility works by monitoring the log files produced by Cabal,
+using `fswatch`, which is available here:
+
+http://emcrisostomo.github.io/fswatch/
+
+A typical use would be to simply invoke it in a sandbox:
+
+    cabal-mon
+
+This will automatically find the directory with the Cabal logs,
+and start up an instance of `fswatch` to monitor the files for modifications.
+
+The default `fswatch` monitor for Mac OS does not report events very
+frequently, so you may have better luck by using the `kqueue` one:
+
+    cabal-mon -m kqueue_monitor
+
+When files are updated, their content will be displayed by the utility.
+The menu uses the following colors:
+
+  * green: this is the package that is currently being watched
+  * red:   this package has changes that you have not yet looked at
+  * white: this package has not changed since the last time you looked at it
+
+
+
+
+
diff --git a/cabal-mon.cabal b/cabal-mon.cabal
--- a/cabal-mon.cabal
+++ b/cabal-mon.cabal
@@ -1,5 +1,5 @@
 name:                cabal-mon
-version:             1.0.0
+version:             1.0.1
 synopsis:            A monitor for cabal builds
 description:         A vty-based wrapper around the `fswatch` utility,
                      which makes it easy to monitor parallel Cabal builds.
@@ -11,6 +11,8 @@
 build-type:          Simple
 cabal-version:       >=1.10
 
+extra-source-files:  README.markdown
+
 executable cabal-mon
   main-is:             CabalMon.hs
   build-depends:
@@ -23,3 +25,8 @@
     directory
   GHC-options: -threaded
   default-language:    Haskell2010
+
+source-repository head
+  type: git
+  location: git://github.com/yav/cabal-mon.git
+