diff --git a/Data/Time/RFC3339.hs b/Data/Time/RFC3339.hs
--- a/Data/Time/RFC3339.hs
+++ b/Data/Time/RFC3339.hs
@@ -13,6 +13,7 @@
 
 module Data.Time.RFC3339 (
     -- * Basic type class
+    -- $basic
     RFC3339(showRFC3339, readRFC3339)
 ) where
 
@@ -32,6 +33,23 @@
 
 -- ----------------------------------------------------------------------------
 -- The RFC3339 class definition
+
+-- $basic
+--  Example of usage:
+--  >
+--  > import Data.Time.LocalTime
+--  >
+--  > showTime :: IO String
+--  > showTime = getZonedTime >>= return . showRFC3339
+--  >
+--  > example1 = "1985-04-12T23:20:50.52Z"
+--  > example2 = "1996-12-19T16:39:57-08:00"
+--  > example3 = "1990-12-31T23:59:60Z"
+--  > example4 = "1990-12-31T15:59:60-08:00"
+--  > example5 = "1937-01-01T12:00:27.87+00:20"
+--  > examples = [example1,example2,example3,example4,example5]
+--  >
+--  > readAll = map readRFC3339 examples
 
 -- | This class is here to allow future support for other data types 
 -- like Data.Text or Data.ByteString if that becomes necessary
diff --git a/rfc3339.cabal b/rfc3339.cabal
--- a/rfc3339.cabal
+++ b/rfc3339.cabal
@@ -1,5 +1,5 @@
 Name:          rfc3339
-Version:       1.0.2
+Version:       1.0.3
 Category:      Web, Time
 Synopsis:      Parse and display time according to RFC3339
 Description:   
@@ -11,25 +11,8 @@
     data types. 
     Right now there is only support for reading and showing String
     .
-    Example of usage:
-    > 
-    > import Data.Time.LocalTime
-    > 
-    > showTime :: IO String
-    > showTime = getZonedTime >>= return . showRFC3339
-    >
-    > example1 = "1985-04-12T23:20:50.52Z"
-    > example2 = "1996-12-19T16:39:57-08:00"
-    > example3 = "1990-12-31T23:59:60Z"
-    > example4 = "1990-12-31T15:59:60-08:00"
-    > example5 = "1937-01-01T12:00:27.87+00:20"
-    > examples = [example1,example2,example3,example4,example5]
-    >
-    > readAll = map readRFC3339 examples
-    >
-    .
-    For more information please read the documentation of the module 
-    bellow.
+    For more information and usage examples please read the documentation of 
+    the module bellow.
     .
 Build-type:    Simple
 Maintainer:    Hugo Daniel Gomes <mr.hugo.gomes@gmail.com>