From f26af00fd0e1775542bc4fab0d906e88a26a17ad Mon Sep 17 00:00:00 2001
From: David Chelimsky <dchelimsky@gmail.com>
Date: Wed, 7 Jul 2010 05:22:33 -0500
Subject: [PATCH] words

---
 README.markdown | 39 ++++++++++++++++++++++++++++++---------
 1 file changed, 30 insertions(+), 9 deletions(-)

diff --git a/README.markdown b/README.markdown
index 48b3ff267..5f8f98232 100644
--- a/README.markdown
+++ b/README.markdown
@@ -3,22 +3,43 @@
 rspec-mocks provides a test-double framework for rspec including support
 for method stubs, fakes, and message expectations.
 
-rspec-mocks is currently in alpha release. While you are welcome to
-track, fork, explore, etc, we're too early in the process to start fielding
-pull requests and or issues from outside the core development team, so please
-don't waste your time until this notice changes.
-
 ## Install
 
-    [sudo] gem install rspec --prerelease
+    gem install rspec --prerelease
 
 This will install rspec, rspec-core, rspec-expectations and rspec-mocks.
 
+## Method Stubs
+
+    describe "consumer" do
+      it "gets stuff from a service" do
+        service = double('service')
+        service.stub(:find) { 'value' }
+        consumer = Consumer.new(service)
+        consumer.consume
+        consumer.aquired_stuff.should eq(['value'])
+      end
+    end
+
+## Message Expectations
+
+    describe "some action" do
+      context "when bad stuff happens" do
+        it "logs the error" do
+          logger = double('logger')
+          doer = Doer.new(logger)
+          logger.should_receive(:log).with('oops')
+          doer.do_something_with(:bad_data)
+        end
+      end
+    end
 
-#### Also see
+## Contribute
+
+See [http://github.com/rspec/rspec-dev](http://github.com/rspec/rspec-dev)
+
+## Also see
 
 * [http://github.com/rspec/rspec](http://github.com/rspec/rspec)
 * [http://github.com/rspec/rspec-core](http://github.com/rspec/rspec-core)
 * [http://github.com/rspec/rspec-expectations](http://github.com/rspec/rspec-expectations)
-* [http://github.com/rspec/rspec-dev](http://github.com/rspec/rspec-dev)
-