diff --git a/CHANGES.textile b/CHANGES.textile
index 91d475c0..75ef1f64 100644
--- a/CHANGES.textile
+++ b/CHANGES.textile
@@ -1,3 +1,7 @@
+h2. 1.0.0
+
+* 1.0.0 release! Party time!
+
 h2. 0.13.1
 
 * Removed property :@name from @XML@ in favor of @:attribute => true@.
diff --git a/lib/representable.rb b/lib/representable.rb
index c47ed10d..984d8c06 100644
--- a/lib/representable.rb
+++ b/lib/representable.rb
@@ -1,5 +1,29 @@
 require 'representable/definition'
 
+# Representable can be used in two ways.
+#
+# == On class level
+#
+# To try out Representable you might include the format module into the represented class directly and then
+# define the properties.
+#
+#   class Hero < ActiveRecord::Base
+#     include Representable::JSON
+#     property :name
+#
+# This will give you to_/from_json for each instance. However, this approach limits your class to one representation.
+#
+# == On module level
+#
+# Modules give you much more flexibility since you can mix them into objects at runtime, roughly following the DCI
+# pattern.
+#
+#   module HeroRepresenter
+#     include Representable::JSON
+#     property :name
+#   end
+#
+#   hero.extend(HeroRepresenter).to_json
 module Representable
   def self.included(base)
     base.class_eval do
diff --git a/lib/representable/version.rb b/lib/representable/version.rb
index 58b6a593..b5b5b85c 100644
--- a/lib/representable/version.rb
+++ b/lib/representable/version.rb
@@ -1,3 +1,3 @@
 module Representable
-  VERSION = "0.13.1"
+  VERSION = "1.0.0"
 end