diff --git a/README.md b/README.md
--- a/README.md
+++ b/README.md
@@ -2,9 +2,94 @@
 
 # haskell-postal
 
-Haskell binding for the libpostal library
-
-You have to install libpostal. Get it from here: https://github.com/openvenues/libpostal
-
 This binding is in alpha state, expect more functionality to come soon. Currently
 it can only be used to do basic parsing and normalization.
+
+## Usage
+
+```haskell
+{-# LANGUAGE OverloadedStrings #-}
+
+import NLP.Postal
+
+main :: IO ()
+main = do
+    setup
+    setupParser
+    setupLanguageClassifier
+
+    apdo <- getAddressParserDefaultOptions
+    pa <- parseAddress apdo "11 Wall Street New York, NY"
+    print pa
+
+    dno <- getDefaultNormalizeOptions
+    xa <- expandAddress dno "11 Wall Street New York, NY"
+    print xa
+
+    tearDownLanguageClassifier
+    tearDownParser
+    tearDown
+```
+
+## Installation
+
+Before using the Haskell binding, you must install the libpostal C library.
+Make sure you have the following prerequisites:
+
+### On Ubuntu/Debian
+
+```
+sudo apt-get install curl autoconf automake libtool pkg-config
+```
+
+### On CentOS/RHEL
+
+```
+sudo yum install curl autoconf automake libtool pkgconfig
+```
+
+### On Mac OSX
+
+```
+sudo brew install curl autoconf automake libtool pkg-config
+```
+
+### Installing libpostal
+
+```
+git clone https://github.com/openvenues/libpostal
+cd libpostal
+./bootstrap.sh
+./configure --datadir=/usr/local/share/libpostal # Needs to have a few GBs of space
+make
+sudo make install
+
+# On Linux it's probably a good idea to run
+sudo ldconfig
+```
+
+### Installing the haskell-postal package
+
+#### From source
+
+Download the source from github, and use the ```cabal``` utility to install it:
+
+```
+git clone https://github.com/netom/haskell-postal
+cd haskell-postal
+cabal install
+```
+
+#### Cabal
+
+Cabal can of course just fetch the package from Hackage:
+
+```
+cabal install haskell-postal
+```
+
+#### Stack
+
+You can of course use stack to install the package, just replace "cabal install"
+with "stack install" anywhere above. Just make sure you try to find the
+installed package where the tool *you* use puts it.
diff --git a/haskell-postal.cabal b/haskell-postal.cabal
--- a/haskell-postal.cabal
+++ b/haskell-postal.cabal
@@ -1,5 +1,5 @@
 name:                haskell-postal
-version:             0.2.1.1
+version:             0.2.1.2
 synopsis:            Haskell binding for the libpostal library
 description:         Provides an interface for the libpostal NLP library
 homepage:            https://github.com/netom/haskell-postal#readme