diff --git a/CHANGELOG.markdown b/CHANGELOG.markdown
new file mode 100644
--- /dev/null
+++ b/CHANGELOG.markdown
@@ -0,0 +1,4 @@
+0.1.5
+-----
+* Claim to be Trustworthy
+* Added a simple example
diff --git a/Control/Concurrent/Supply.hs b/Control/Concurrent/Supply.hs
--- a/Control/Concurrent/Supply.hs
+++ b/Control/Concurrent/Supply.hs
@@ -1,4 +1,7 @@
-{-# LANGUAGE MagicHash, UnboxedTuples #-}
+{-# LANGUAGE MagicHash, UnboxedTuples, CPP #-}
+#if defined(__GLASGOW_HASKELL__) && __GLASGOW_HASKELL__ >= 702
+{-# LANGUAGE Trustworthy #-}
+#endif
 -----------------------------------------------------------------------------
 -- |
 -- Module      :  Control.Concurrent.Supply
@@ -9,8 +12,20 @@
 -- Stability   :  provisional
 -- Portability :  portable
 --
--- A globally unique fresh identifier supply with local pooling and replay
+-- A fast unique identifier supply with local pooling and replay
 -- support.
+--
+-- One often has a desire to generate a bunch of integer identifiers within
+-- a single process that are unique within that process. You could use
+-- UUIDs, but they can be expensive to generate; you don't want to have
+-- your threads contending for a single external counter if the identifier
+-- is not going to be used outside the process.
+--
+-- @concurrent-supply@ builds a tree-like structure which can be split; you
+-- can make smaller unique supplies and then you allocate from your supplies
+-- locally. Internally it pulls from a unique supply one block at a time as
+-- you walk into parts of the tree that haven't been explored.
+--
 ----------------------------------------------------------------------------
 module Control.Concurrent.Supply
   ( Supply
diff --git a/concurrent-supply.cabal b/concurrent-supply.cabal
--- a/concurrent-supply.cabal
+++ b/concurrent-supply.cabal
@@ -1,6 +1,6 @@
 name:          concurrent-supply
 category:      Concurrency, Parallelism
-version:       0.1.4.1
+version:       0.1.5
 license:       BSD3
 cabal-version: >= 1.10
 license-file:  LICENSE
@@ -11,9 +11,12 @@
 bug-reports:   http://github.com/ekmett/concurrent-supply/issues
 copyright:     Copyright (C) 2011 Edward A. Kmett
 synopsis:      A fast concurrent unique identifier supply with a pure API
-description:   A fast concurrent unique identifier supply with a pure API
+description:   A fast supply of concurrent unique identifiers suitable for use
+    within a single process. Once the initial 'Supply' has been initialized,
+    the remainder of the API is pure. See "Control.Concurrent.Supply" for
+    details.
 build-type:    Simple
-extra-source-files: .travis.yml
+extra-source-files: .travis.yml CHANGELOG.markdown
 
 source-repository head
   type: git