diff --git a/README.md b/README.md
new file mode 100644
--- /dev/null
+++ b/README.md
@@ -0,0 +1,7 @@
+# aeson-better-errors
+
+A small package which gives you tools to build parsers to decode JSON values,
+and gives good error messages when parsing fails.
+
+* Announcement blog post / tutorial: <http://harry.garrood.me/blog/aeson-better-errors/>
+* Hackage: <https://hackage.haskell.org/package/aeson-better-errors>
diff --git a/aeson-better-errors.cabal b/aeson-better-errors.cabal
--- a/aeson-better-errors.cabal
+++ b/aeson-better-errors.cabal
@@ -1,5 +1,5 @@
 name:                aeson-better-errors
-version:             0.1.0.0
+version:             0.1.0.1
 synopsis:            Better error messages when decoding JSON values.
 license:             MIT
 license-file:        LICENSE
@@ -9,6 +9,7 @@
 category:            Text, Web, JSON
 build-type:          Simple
 cabal-version:       >=1.10
+extra-source-files:  README.md
 
 description:
   A small package which gives you the tools to build parsers to decode JSON
diff --git a/src/Data/Aeson/BetterErrors.hs b/src/Data/Aeson/BetterErrors.hs
--- a/src/Data/Aeson/BetterErrors.hs
+++ b/src/Data/Aeson/BetterErrors.hs
@@ -1,11 +1,15 @@
 {-# OPTIONS_GHC -fno-warn-unused-imports #-}
 
--- | A module for decoding JSON, and generating good better messages. Note,
+-- | A module for decoding JSON, and generating good error messages. Note,
 -- however, that this package only deals with generating good error messages
 -- /after/ the JSON has been parsed into a 'Data.Aeson.Value' - unfortunately,
 -- invalid JSON will still produce poor error messages.
 --
--- See <http://harry.garrood.me/blog/aeson-better-errors/>
+-- See <http://harry.garrood.me/blog/aeson-better-errors/> for a tutorial.
+--
+-- Any kind of feedback is very welcome: suggestions for a better designed API,
+-- bug reports, whatever - the best place for it is probably the GitHub issue
+-- tracker: <https://github.com/hdgarrood/aeson-better-errors/issues>.
 
 module Data.Aeson.BetterErrors
   ( -- * The Parser type