diff --git a/hspec-discover.cabal b/hspec-discover.cabal
--- a/hspec-discover.cabal
+++ b/hspec-discover.cabal
@@ -1,5 +1,5 @@
 name:             hspec-discover
-version:          0.0.2
+version:          0.0.3
 license:          MIT
 license-file:     LICENSE
 copyright:        (c) 2012 Simon Hengel
@@ -9,7 +9,32 @@
 cabal-version:    >= 1.8
 category:         Testing
 synopsis:         Automatically discover and run Hspec tests
-description:      Documentation is here: <https://github.com/sol/hspec-discover#readme>
+description:      Say you have a driver module for your test suite.
+                  .
+                  > module Main where
+                  >
+                  > import Test.Hspec.Monadic
+                  >
+                  > import qualified FooSpec
+                  > import qualified Foo.BarSpec
+                  > import qualified BazSpec
+                  >
+                  > main :: IO ()
+                  > main = hspecX $ do
+                  >   describe "Foo"     FooSpec.spec
+                  >   describe "Foo.Bar" Foo.BarSpec.spec
+                  >   describe "Baz"     BazSpec.spec
+                  .
+                  Then you can replace it with the following.
+                  .
+                  > {-# OPTIONS_GHC -F -pgmF hspec-discover #-}
+                  .
+                  All files with a name that ends in @Spec.hs@ are include in
+                  the generated test suite.  And it is assumed, that they
+                  export a @spec@ of type `Test.Hspec.Monadic.Specs`.
+                  .
+                  Full documentation is here:
+                  <https://github.com/sol/hspec-discover#readme>
 
 source-repository head
   type: git
diff --git a/src/Test/Hspec/Discover.hs b/src/Test/Hspec/Discover.hs
--- a/src/Test/Hspec/Discover.hs
+++ b/src/Test/Hspec/Discover.hs
@@ -1,7 +1,37 @@
-{-# OPTIONS_HADDOCK hide #-}
+{-# OPTIONS_HADDOCK prune #-}
+-- |
+-- Say you have a driver module for your test suite.
+--
+-- > module Main where
+-- >
+-- > import Test.Hspec.Monadic
+-- >
+-- > import qualified FooSpec
+-- > import qualified Foo.BarSpec
+-- > import qualified BazSpec
+-- >
+-- > main :: IO ()
+-- > main = hspecX $ do
+-- >   describe "Foo"     FooSpec.spec
+-- >   describe "Foo.Bar" Foo.BarSpec.spec
+-- >   describe "Baz"     BazSpec.spec
+--
+-- Then you can replace it with the following.
+--
+-- > {-# OPTIONS_GHC -F -pgmF hspec-discover #-}
+--
+-- All files with a name that ends in @Spec.hs@ are include in the generated
+-- test suite.  And it is assumed, that they export a @spec@ of type
+-- `Test.Hspec.Monadic.Specs`.
+--
+-- Full documentation is here: <https://github.com/sol/hspec-discover#readme>
 module Test.Hspec.Discover (hspec, describe) where
 
-import Test.Hspec.Monadic (Specs, hspecX, describe)
+import           Test.Hspec.Monadic (Specs)
+import qualified Test.Hspec.Monadic as Hspec
 
 hspec :: Specs -> IO ()
-hspec = hspecX
+hspec = Hspec.hspecX
+
+describe :: String -> Specs -> Specs
+describe = Hspec.describe