diff --git a/README.md b/README.md
new file mode 100644
--- /dev/null
+++ b/README.md
@@ -0,0 +1,35 @@
+# Djembe
+
+Djembe is a Haskell embedded domain-specific language for composing drum beats.
+
+## Example
+
+Let's define a few quarter note length drum hits
+```haskell
+bass  = n4 $ hsong (Hit BassDrum1 0 100)
+snare = n4 $ hsong (Hit SnareDrum2 0 100)
+hihat = n4 $ hsong (Hit ClosedHihat 0 100)
+```
+
+Now let's create a simple composition
+```haskell
+beat = bass <> snare <> bass <> hihat
+```
+
+Finally we can play it at a specific tempo
+```haskell
+> play beat 200
+```
+
+We can also compose beats using [dseq](http://www.csounds.com/journal/issue8/dseq.html) notation
+``` haskell
+funky = dseq OpenHihat   8 ".... ...7 .... .7.."
+     <> dseq ClosedHihat 8 "7777 777. 7777 7.77"
+     <> dseq SnareDrum1  8 ".... 7..7 .7.7 7..7"
+     <> dseq BassDrum1   8 "7.7. ..7. ..7. .7.."
+```
+
+## Inspiration
+- [Bang](https://github.com/5outh/Bang)
+- [The Haskell School of Music / Paul Hudak](http://haskell.cs.yale.edu/?post_type=publication&p=112)
+- [dseq](http://www.csounds.com/journal/issue8/dseq.html)
diff --git a/djembe.cabal b/djembe.cabal
--- a/djembe.cabal
+++ b/djembe.cabal
@@ -2,7 +2,7 @@
 -- documentation, see http://haskell.org/cabal/users-guide/
 
 name:                djembe
-version:             0.1.1.1
+version:             0.1.1.2
 synopsis:            Hit drums with haskell           
 description:
   A simple DSL for composing drum beats in haskell.
@@ -16,6 +16,7 @@
 copyright:           2015 Reed Rosenbluth
 category:            Sound
 build-type:          Simple
+extra-source-files:  README.md
 cabal-version:       >=1.10
 
 library