diff --git a/README.rdoc b/README.rdoc
index f1c61bd..e4f1242 100644
--- a/README.rdoc
+++ b/README.rdoc
@@ -50,7 +50,8 @@ Creating and Querying Views:
 
 == CouchRest::Model
 
-CouchRest::Model is a module designed along the lines of DataMapper::Resource. By 
-including it in your class, suddenly you get all sorts of magic sugar, so that
-working with CouchDB in your Rails or Merb app is no harder than working with the
-standard SQL alternatives. See the CouchRest::Model documentation for an example article class that illustrates usage.
+CouchRest::Model is a module designed along the lines of DataMapper::Resource.
+By subclassing, suddenly you get all sorts of powerful sugar, so that working
+with CouchDB in your Rails or Merb app is no harder than working with the
+standard SQL alternatives. See the CouchRest::Model documentation for an
+example article class that illustrates usage.
diff --git a/lib/couchrest/core/model.rb b/lib/couchrest/core/model.rb
index 2b390af..5015999 100644
--- a/lib/couchrest/core/model.rb
+++ b/lib/couchrest/core/model.rb
@@ -2,7 +2,7 @@
 module CouchRest
   # = CouchRest::Model - ORM, the CouchDB way
   # 
-  # CouchRest::Model provides an ORM-like interface for CouchDB documents. It avoids all usage of <tt>method_missing</tt>, and tries to strike a balance between usability and magic. See CouchRest::Model::MagicViews#view_by for documentation about the view-generation system. For the other class methods, inspiried by DataMapper and ActiveRecord, see CouchRest::Model::ClassMethods. The InstanceMethods are pretty basic.
+  # CouchRest::Model provides an ORM-like interface for CouchDB documents. It avoids all usage of <tt>method_missing</tt>, and tries to strike a balance between usability and magic. See CouchRest::Model#view_by for documentation about the view-generation system.
   # 
   # ==== Example
   #