diff --git a/Readme.md b/Readme.md
new file mode 100644
--- /dev/null
+++ b/Readme.md
@@ -0,0 +1,29 @@
+# Edit [![Hackage badge](https://img.shields.io/hackage/v/edit.svg?label=Hackage)](https://hackage.haskell.org/package/edit)
+
+The `Edit` monad allows you to easily bubble up whether a change was made or
+not when rewriting things. Some cases where this can be handy:
+
+1. You are making a sequence of transformations on some type and want to keep
+   track of whether any of them changed it or not.
+2. You are rewriting a recursive type and want to bubble up information
+   whether something was changed or not.
+
+A small example:
+
+```haskell
+>>> halveEvens x = if x `mod` 2 == 0 then (Dirty $ x `div` 2) else (Clean x)
+>>> traverse halveEvens [1, 2, 3]
+Dirty [1,1,3]
+>>> traverse halveEvens [1, 3, 5]
+Clean [1,3,5]
+```
+
+More thorough documentation is available on [Hackage](https://hackage.haskell.org/package/edit)
+under the `Data.Edit` module. There is a tutorial too under `Data.Edit.Tutorial`.
+
+There is also a corresponding monad transformer `EditT` available under `Control.Monad.Trans.EditT`.
+
+# Contributing
+
+Please open an issue on the Github issue tracker to discuss missing documentation,
+API changes etc.
diff --git a/edit.cabal b/edit.cabal
--- a/edit.cabal
+++ b/edit.cabal
@@ -1,5 +1,5 @@
 name:                edit
-version:             0.0.1.0
+version:             0.0.1.1
 synopsis:            A monad for rewriting things.
 homepage:            https://github.com/theindigamer/edit
 license:             BSD3
@@ -9,7 +9,7 @@
 copyright:           Varun Gandhi 2018
 category:            Data
 build-type:          Simple
-extra-source-files:  ChangeLog.md
+extra-source-files:  ChangeLog.md, Readme.md
 cabal-version:       >=1.10
 description:
    Edit is a monad for rewriting things.