diff --git a/CHANGELOG b/CHANGELOG
deleted file mode 100644
--- a/CHANGELOG
+++ /dev/null
@@ -1,28 +0,0 @@
-- 0.10.2.1
-    * Bump websockets to 0.11.0.0
-
-- 0.10.2.0
-    * Bump websockets to 0.10.0.0
-
-- 0.10.1.1
-    * Add `bytestring-builder` as dependency to fix GHC 7.6 compatibility
-
-- 0.10.1.0
-    * Fix issues with timeout tickling
-
-- 0.10.0.0
-    * Bump snap-core and snap-server to 1.0.0.0
-    * Remove git submodules; use hackage for all dependencies
-    * Use cabal.project file to build example server
-
-- 0.9.2.0
-    * Bump websockets to 0.9.5.0 to fix socket closing issues
-
-- 0.9.1.0
-    * Fixed interleaved messages issue
-
-- 0.9.0.0
-    * Bump websockets dependency
-
-- 0.8.2.2
-    * Bump mtl dependency
diff --git a/CHANGELOG.md b/CHANGELOG.md
new file mode 100644
--- /dev/null
+++ b/CHANGELOG.md
@@ -0,0 +1,31 @@
+- 0.10.2.2
+    * Bump io-streams to 1.4.0.0
+
+- 0.10.2.1
+    * Bump websockets to 0.11.0.0
+
+- 0.10.2.0
+    * Bump websockets to 0.10.0.0
+
+- 0.10.1.1
+    * Add `bytestring-builder` as dependency to fix GHC 7.6 compatibility
+
+- 0.10.1.0
+    * Fix issues with timeout tickling
+
+- 0.10.0.0
+    * Bump snap-core and snap-server to 1.0.0.0
+    * Remove git submodules; use hackage for all dependencies
+    * Use cabal.project file to build example server
+
+- 0.9.2.0
+    * Bump websockets to 0.9.5.0 to fix socket closing issues
+
+- 0.9.1.0
+    * Fixed interleaved messages issue
+
+- 0.9.0.0
+    * Bump websockets dependency
+
+- 0.8.2.2
+    * Bump mtl dependency
diff --git a/README.md b/README.md
new file mode 100644
--- /dev/null
+++ b/README.md
@@ -0,0 +1,12 @@
+websockets-snap
+===============
+
+Provides [Snap] integration for the [websockets] library.
+
+This library must be used with the threaded GHC runtime system. You can do this
+by using something like this in your cabal file:
+
+    ghc-options: -Wall -threaded -rtsopts "-with-rtsopts=-N"
+
+[Snap]: http://snapframework.com/
+[websockets]: http://jaspervdj.be/websockets/
diff --git a/websockets-snap.cabal b/websockets-snap.cabal
--- a/websockets-snap.cabal
+++ b/websockets-snap.cabal
@@ -1,5 +1,5 @@
 Name:          websockets-snap
-Version:       0.10.2.1
+Version:       0.10.2.2
 Synopsis:      Snap integration for the websockets library
 Description:   Snap integration for the websockets library
 License:       BSD3
@@ -11,7 +11,8 @@
 Cabal-version: >= 1.6
 
 Extra-source-files:
-  CHANGELOG
+  CHANGELOG.md
+  README.md
 
 Library
   Hs-source-dirs: src
@@ -24,7 +25,7 @@
     base               >= 4     && < 5,
     bytestring         >= 0.9   && < 0.11,
     bytestring-builder >= 0.10  && < 0.11,
-    io-streams         >= 1.3   && < 1.4,
+    io-streams         >= 1.3   && < 1.5,
     mtl                >= 2.1   && < 2.3,
     snap-core          >= 1.0   && < 1.1,
     snap-server        >= 1.0   && < 1.1,