diff --git a/README.md b/README.md
new file mode 100644
--- /dev/null
+++ b/README.md
@@ -0,0 +1,31 @@
+This is now **deprecated** and it is better to use the
+[random](https://hackage.haskell.org/package/random "well maintained")
+package as the source of randomness.
+
+Here's what you might have written before:
+
+```
+import qualified Data.Random as Random
+import qualified Data.Random.Distribution.Bernoulli as Bernoulli
+
+main :: IO ()
+main = do
+  x <- Random.sample $ Bernoulli.Bernoulli (0.5 :: Double) :: IO Double
+  print x
+```
+
+And here's what you should write now (but there are many other options):
+
+```
+import qualified System.Random.Stateful as Random.Stateful
+import qualified Data.Random as Random
+import qualified Data.Random.Distribution.Bernoulli as Bernoulli
+import qualified Control.Monad.Reader as Reader
+
+main :: IO ()
+main = do
+  stdgen <- Random.Stateful.newIOGenM =<< Random.Stateful.newStdGen
+  x <- Reader.runReaderT (Random.sample $ Bernoulli.Bernoulli (0.5 :: Double)) stdgen
+        :: IO Double
+  print x
+```
diff --git a/random-source.cabal b/random-source.cabal
--- a/random-source.cabal
+++ b/random-source.cabal
@@ -1,5 +1,5 @@
 name:                   random-source
-version:                0.3.0.12
+version:                0.3.0.13
 stability:              provisional
 
 cabal-version:          >= 1.10
@@ -18,10 +18,13 @@
                         \"completing\" partial implementations, making it
                         easy to define new entropy sources in a way that
                         is naturally forward-compatible.
+                        Now DEPRECATED: see [README](#readme) for further
+                        details.
 
 tested-with:            GHC == 7.4.2, GHC == 7.6.1
 
 extra-source-files:     changelog.md
+                        README.md
 
 source-repository head
   type:                 git