diff --git a/ChangeLog.md b/ChangeLog.md
new file mode 100644
--- /dev/null
+++ b/ChangeLog.md
@@ -0,0 +1,1 @@
+No changes logged yet
diff --git a/README.md b/README.md
new file mode 100644
--- /dev/null
+++ b/README.md
@@ -0,0 +1,18 @@
+
+## REQUIRED PACKAGES
+
+The example, chat.hs, requires `stm-lifted` and `conduit-combinators`
+which are not dependencies of `yesod-websockets`. Installing the extra
+packages needed for the chat.hs example can be installed with the
+command:
+
+    $ cabal install stm-lifted conduit-combinators
+
+
+## TIMEOUTS
+
+Versions of `yesod-websockets` prior to 0.2.1 may experience session
+timeouts after about 30 seconds of inactivity. Refer to the patch in
+the `websockets` library which addresses this issue:
+
+https://github.com/jaspervdj/websockets/commit/536849d1f3265076f61edefd5c89e84e82a99c71
diff --git a/yesod-websockets.cabal b/yesod-websockets.cabal
--- a/yesod-websockets.cabal
+++ b/yesod-websockets.cabal
@@ -1,5 +1,5 @@
 name:                yesod-websockets
-version:             0.2.1
+version:             0.2.1.1
 synopsis:            WebSockets support for Yesod
 description:         WebSockets support for Yesod
 homepage:            https://github.com/yesodweb/yesod
@@ -10,6 +10,8 @@
 category:            Web
 build-type:          Simple
 cabal-version:       >=1.8
+description:         API docs and the README are available at <http://www.stackage.org/package/yesod-websockets>
+extra-source-files:  README.md ChangeLog.md
 
 library
   exposed-modules:     Yesod.WebSockets