diff --git a/ChangeLog.md b/ChangeLog.md
--- a/ChangeLog.md
+++ b/ChangeLog.md
@@ -1,5 +1,11 @@
 # Revision history for streaming-cassava
 
-## 0.1.0.0  -- 2017-06-30
+## 0.1.0.1 -- 2018-01-23
+
+* Bump dependency on `streaming`.
+
+* Document what to do with `readFile` errors.
+
+## 0.1.0.0 -- 2017-06-30
 
 * First version.
diff --git a/README.md b/README.md
--- a/README.md
+++ b/README.md
@@ -1,7 +1,7 @@
 streaming-cassava
 =================
 
-[![Hackage](https://img.shields.io/hackage/v/streaming-cassava.svg)](https://hackage.haskell.org/package/streaming-cassava) [![Build Status](https://travis-ci.org/ivan-m/streaming-cassava.svg)](https://travis-ci.org/ivan-m/streaming-cassava)
+[![Hackage](https://img.shields.io/hackage/v/streaming-cassava.svg)](https://hackage.haskell.org/package/streaming-cassava) [![Build Status](https://travis-ci.org/haskell-streaming/streaming-cassava.svg)](https://travis-ci.org/haskell-streaming/streaming-cassava)
 
 > [cassava] support for the [streaming] ecosystem
 
@@ -17,3 +17,23 @@
 automatically add on default headers and you can even choose whether
 to fail on the first parse error or handle errors on a row-by-row
 basis.
+
+Errors with `readFile`
+----------------------
+
+A common use-case is to stream CSV-encoded data in from a file.  You
+may be tempted to use `readFile` from [streaming-bytestring] to obtain
+the file contents, but if you do you're likely to run into exceptions
+such as `hGetBufSome: illegal operation (handle is closed)`.
+
+The recommended solution is to use the [streaming-with] package for
+the IO aspects.  You can then write something like:
+
+```haskell
+withBinaryFileContents \"myFile.csv\" $
+  doSomethingWithStreamingCSV
+  . 'decodeByName'
+```
+
+[streaming-bytestring]: https://hackage.haskell.org/package/streaming-bytestring
+[streaming-with]: https://hackage.haskell.org/package/streaming-with
diff --git a/src/Streaming/Cassava.hs b/src/Streaming/Cassava.hs
--- a/src/Streaming/Cassava.hs
+++ b/src/Streaming/Cassava.hs
@@ -8,7 +8,25 @@
    License     : MIT
    Maintainer  : Ivan.Miljenovic@gmail.com
 
+   Stream CSV data in\/out using
+   [Cassava](http://hackage.haskell.org/package/cassava).
 
+   A common use-case is to stream CSV-encoded data in from a file.
+   You may be tempted to use 'B.readFile' from
+   "Data.ByteString.Streaming" to obtain the file contents, but if you
+   do you're likely to run into exceptions such as:
+
+   > hGetBufSome: illegal operation (handle is closed)
+
+   One solution is to use the
+   [streaming-with](https://hackage.haskell.org/package/streaming-with)
+   package for the IO aspects.  You can then write something like:
+
+   @
+     withBinaryFileContents \"myFile.csv\" $
+       doSomethingWithStreamingCSV
+       . 'decodeByName'
+   @
 
  -}
 module Streaming.Cassava
diff --git a/streaming-cassava.cabal b/streaming-cassava.cabal
--- a/streaming-cassava.cabal
+++ b/streaming-cassava.cabal
@@ -1,5 +1,5 @@
 name:                streaming-cassava
-version:             0.1.0.0
+version:             0.1.0.1
 synopsis:            Cassava support for the streaming ecosystem
 
 description:
@@ -20,7 +20,7 @@
 
 source-repository head
   type:     git
-  location: https://github.com/ivan-m/streaming-cassava.git
+  location: https://github.com/haskell-streaming/streaming-cassava.git
 
 library
   exposed-modules:     Streaming.Cassava
@@ -28,7 +28,7 @@
                      , bytestring
                      , cassava == 0.5.*
                      , mtl
-                     , streaming >= 0.1.1.0 && < 0.2
+                     , streaming >= 0.1.1.0 && < 0.3
                      , streaming-bytestring < 0.2
                      , transformers
   hs-source-dirs:      src