README.md in twilio-ruby-0.4.0 vs README.md in twilio-ruby-3.0.0

@@ -1,13 +1,87 @@
 ## Get Started
 
-Review [examples.rb](twilio-ruby/blob/master/examples.rb) to see how to get started using twilio-ruby.
-
 To install:
 
+Via rubygems.org:
+
+```
 $ sudo gem install twilio-ruby
+```
 
 To build and install yourself from the latest source:
 
-1) git clone this repo
-2) $ cd twilio-ruby; gem build .gemspec
-3) sudo gem install twilio-ruby-{version}
+```
+$ git clone [e-mail]:andrewmbenton/twilio-ruby.git
+$ cd twilio-ruby; rake gem
+$ sudo gem install pkg/twilio-ruby-{version}
+```
+
+## Some Code To Get You Started
+
+### Setup Work
+
+``` ruby
+require 'rubygems'
+require 'twilio-ruby'
+
+# put your own credentials here
+@account_sid = 'AC043dcf9844e04758bc3a36a84c29761'
+@auth_token = '62ea81de3a5b414154eb263595357c69'
+
+# set up a client to talk to the Twilio REST API
+@client = Twilio::REST::Client.new(@account_sid, @auth_token)
+```
+
+### Send an SMS
+
+``` ruby
+# send an sms
[e-mail](
+  :from => '[phone]',
+  :to => '[phone]',
+  :body => 'Hey there!'
+)
+```
+
+### Do Some Stuff With Calls
+
+``` ruby
+# make a new outgoing call
+@call = @client.account.calls.create(
+  :from => '[phone]',
+  :to => '[phone]',
+  :url => 'http://myapp.com/call-handler'
+)
+
+# hangup a ringing call, but don't touch it if it's connected
[e-mail]
+
+# if you have the call sid, you can fetch a call object via:
+@call = @client.account.calls.get('CA386025c9bf5d6052a1d1ea42b4d16662')
+
+# redirect an in-progress call
[e-mail]_to('http://myapp.com/call-redirect')
+
+# hangup a call, no matter whether it is ringing or connected
[e-mail]
+```
+
+### Buy a Phone Number
+
+``` ruby
+# print some available numbers
+@numbers = @client.account.available_phone_numbers.get('US').local.list(
+  :contains => 'AWESOME'
+)
[e-mail] {|num| puts num.phone_number}
+
+# buy the first one
+@number = @numbers[0].phone_number
[e-mail]_phone_numbers.create(:phone_number => @number)
+```
+
+## More Information
+
+There are more detailed examples in the included [examples.rb](twilio-ruby/blob/master/examples.rb).
+
+Full [API documentation](twilio-ruby/wiki/Documentation), as well as an [upgrade guide](twilio-ruby/wiki/UpgradeGuide) for users of the old twiliolib gem, is available in the [twilio-ruby github wiki](twilio-ruby/wiki).
\ No newline at end of file