README.rdoc in jchris-couchrest-0.9.9 vs README.rdoc in jchris-couchrest-0.9.10

- old
+ new

@@ -1,22 +1,32 @@ == CouchRest - CouchDB, close to the metal -CouchRest is based on [CouchDB's couch.js test library](http://svn.apache.org/repos/asf/incubator/couchdb/trunk/share/www/script/couch.js), which I find to be concise, clear, and well designed. CouchRest lightly wraps CouchDB's HTTP API, managing JSON serialization, and remembering the URI-paths to CouchDB's API endpoints so you don't have to. +CouchRest is based on [CouchDB's couch.js test +library](http://svn.apache.org/repos/asf/incubator/couchdb/trunk/share/www/script/couch.js), +which I find to be concise, clear, and well designed. CouchRest lightly wraps +CouchDB's HTTP API, managing JSON serialization, and remembering the URI-paths +to CouchDB's API endpoints so you don't have to. -CouchRest's lighweight is designed to make a simple base for application and framework-specific object oriented APIs. +CouchRest's lighweight is designed to make a simple base for application and +framework-specific object oriented APIs. === Easy Install sudo gem install jchris-couchrest -s http://gems.github.com === Relax, it's RESTful -The core of Couchrest is Heroku’s excellent REST Client Ruby HTTP wrapper. REST Client takes all the nastyness of Net::HTTP and gives is a pretty face, while still giving you more control than Open-URI. I recommend it anytime you’re interfacing with a well-defined web service. +The core of Couchrest is Heroku’s excellent REST Client Ruby HTTP wrapper. +REST Client takes all the nastyness of Net::HTTP and gives is a pretty face, +while still giving you more control than Open-URI. I recommend it anytime +you’re interfacing with a well-defined web service. === Running the Specs -The most complete documentation is the spec/ directory. To validate your CouchRest install, from the project root directory run `rake`, or `autotest` (requires RSpec and optionally ZenTest for autotest support). +The most complete documentation is the spec/ directory. To validate your +CouchRest install, from the project root directory run `rake`, or `autotest` +(requires RSpec and optionally ZenTest for autotest support). === Examples Quick Start: @@ -48,9 +58,10 @@ }) puts @db.view('first/test')['rows'].inspect == 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 and 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.