diff --git a/CHANGELOG.md b/CHANGELOG.md
--- a/CHANGELOG.md
+++ b/CHANGELOG.md
@@ -1,5 +1,9 @@
 # Change log
 
+## Release 1.2.2
+
+* Minor documentation improvements
+
 ## Release 1.2.1
 
 * Fixed an issue where compressing certain JPEGs would also rotate them, due to metadata being stripped (#11).
diff --git a/hakyll-images.cabal b/hakyll-images.cabal
--- a/hakyll-images.cabal
+++ b/hakyll-images.cabal
@@ -1,7 +1,7 @@
 cabal-version: 2.2
 
 name:           hakyll-images
-version:        1.2.1
+version:        1.2.2
 synopsis:       Hakyll utilities to work with images
 description:    hakyll-images is an add-on to the hakyll package. It adds utilities to work with images, including JPEG compression.
 category:       Web
diff --git a/library/Hakyll/Images/Common.hs b/library/Hakyll/Images/Common.hs
--- a/library/Hakyll/Images/Common.hs
+++ b/library/Hakyll/Images/Common.hs
@@ -66,8 +66,7 @@
 -- @
 -- match "*.jpg" $ do
 --     route idRoute
---     compile $ loadImage
---         >>= compressJpgCompiler 50
+--     compile $ loadImage >>= compressJpgCompiler 50
 -- @
 loadImage :: Compiler (Item Image)
 loadImage = do
diff --git a/library/Hakyll/Images/CompressJpg.hs b/library/Hakyll/Images/CompressJpg.hs
--- a/library/Hakyll/Images/CompressJpg.hs
+++ b/library/Hakyll/Images/CompressJpg.hs
@@ -128,8 +128,7 @@
 -- @
 -- match "*.jpg" $ do
 --     route idRoute
---     compile $ loadImage
---         >>= compressJpgCompiler 50
+--     compile $ loadImage >>= compressJpgCompiler 50
 -- @
 compressJpgCompiler :: Integral a => a -> Item Image -> Compiler (Item Image)
 compressJpgCompiler quality = return . fmap (compressJpg quality)
diff --git a/library/Hakyll/Images/Metadata.hs b/library/Hakyll/Images/Metadata.hs
--- a/library/Hakyll/Images/Metadata.hs
+++ b/library/Hakyll/Images/Metadata.hs
@@ -32,8 +32,7 @@
 -- match "*.jpg" $ do
 --     route idRoute
 --     compile $ do
---         im <- loadImage
---         meta <- imageMetadata
+--         meta <- imageMetadata =<< loadImage
 --         doSomethingWithMetadata meta
 --         ...
 -- @
diff --git a/library/Hakyll/Images/Resize.hs b/library/Hakyll/Images/Resize.hs
--- a/library/Hakyll/Images/Resize.hs
+++ b/library/Hakyll/Images/Resize.hs
@@ -25,14 +25,12 @@
 --         -- Resize all profile pictures with .png extensions to 64x48
 --         match "profiles/**.png" $ do
 --             route idRoute
---             compile $ loadImage
---                 >>= resizeImageCompiler 64 48
+--             compile $ loadImage >>= resizeImageCompiler 64 48
 --
 --         -- Scale images to fit within a 600x400 box
 --         match "images/**" $ do
 --             route idRoute
---             compile $ loadImage
---                 >>= scaleImageCompiler 600 400
+--             compile $ loadImage >>= scaleImageCompiler 600 400
 --
 --         (... omitted ...)
 -- @
@@ -130,8 +128,7 @@
 -- @
 -- match "*.png" $ do
 --     route idRoute
---     compile $ loadImage
---         >>= resizeImageCompiler 48 64
+--     compile $ loadImage >>= resizeImageCompiler 48 64
 -- @
 --
 -- Note that in the resizing process, images will be converted to RGBA8.
@@ -147,8 +144,7 @@
 -- @
 -- match "*.tiff" $ do
 --     route idRoute
---     compile $ loadImage
---         >>= scaleImageCompiler 48 64
+--     compile $ loadImage >>= scaleImageCompiler 48 64
 -- @
 --
 -- Note that in the resizing process, images will be converted to RGBA8.
@@ -164,8 +160,7 @@
 -- @
 -- match "*.tiff" $ do
 --     route idRoute
---     compile $ loadImage
---         >>= ensureFitCompiler 48 64
+--     compile $ loadImage >>= ensureFitCompiler 48 64
 -- @
 --
 -- Note that in the resizing process, images will be converted to RGBA8.