diff --git a/README.md b/README.md
new file mode 100644
--- /dev/null
+++ b/README.md
@@ -0,0 +1,62 @@
+A haskell implementation of a [sphinx full text search](http://sphinxsearch.com) client.
+Sphinx is a very fast and featureful full-text search daemon.
+Version 0.4 is Compatible with sphinx version 1.1-beta
+Version 0.5 is Compatible with sphinx version 2.0-beta, but you can pass the version-one-one build flag.
+[On hackage](http://hackage.haskell.org/package/sphinx).
+
+# Usage
+
+`query` executes a single query.
+`runQueries` executes multiple queries at once that were created them with `addQuery`
+
+In extended mode you may want to escape special query characters with `escapeString`
+
+`buildExcerpts` creates highlighted excerpts
+
+You will probably need to import the types also:
+
+    import qualified Text.Search.Sphinx as Sphinx
+    import qualified Text.Search.Sphinx.Types as SphinxT
+
+There is also an `Indexable` module for generating an xml file of data to be indexed
+
+## runQueries helpers
+
+`runQueries` pipelines multiple queries together. If you are trying to combine the results, there are some helpers such as `maybeQueries` and `resultsToMatches`
+
+~~~~~~ {.haskell}
+      mr <- Sphinx.maybeQueries sphinxLogger sphinxConfig [
+                 addQuery "db1" query1
+               , addQuery "db2" query1
+               , addQuery "db1" query2
+               , addQuery "db2" query2
+               ]
+      case mr of
+        Nothing -> return Nothing
+        Just rs -> do
+          let combined = Sphinx.resultsToMatches 20 rs
+          if null combined
+             then return Nothing
+             else return $ Just combined
+~~~~~~
+
+
+
+
+Details
+=======
+
+Implemenation
+-------------
+Implementation of API as detailed in [the documentation](http://sphinxsearch.com/docs/manual-1.10.html).
+Most search and buildExcerpts features are implemented.
+
+History
+-------
+Originally written by Tupil and maintained by Chris Eidhof for an earlier version of sphinx.
+Greg Weber improved the library and updated it for the latest version of sphinx, and is now maintaining it.
+
+Usage of this haskell client
+----------------------------
+Tupil originally wrote this for use on a commercial project.
+This sphinx package is now finding some use in the Yesod community. [Here is a well described example usage](http://www.yesodweb.com/book/sphinx), but do keep in mind there is no requirement to tie the *generation* of sphinx documents to your web application, just your database. Used in Yesod applications yesdoweb.com and eatnutrients.com.
diff --git a/sphinx.cabal b/sphinx.cabal
--- a/sphinx.cabal
+++ b/sphinx.cabal
@@ -1,5 +1,5 @@
 Name:            sphinx
-Version:         0.5.3
+Version:         0.5.3.1
 Synopsis:        Haskell bindings to the Sphinx full-text searching daemon.
 Description:     Haskell bindings to the Sphinx full-text searching daemon. Compatible with Sphinx version 2.0
 Category:        Text, Search, Database
@@ -11,6 +11,8 @@
 
 cabal-version:   >= 1.2
 Build-Type:      Simple
+
+extra-source-files: README.md
 
 Flag version-1-1-beta
   Description: By default this library is compatible with version 2.0 beta of Sphinx.